Get a contact
/v1/contacts/{contact_id}const contact = await bird.contacts.get("con_01krdgeqcxet5s7t44vh8rt9mg");
console.log(contact.email, contact.first_name);contact = client.contacts.get("con_01krdgeqcxet5s7t44vh8rt9mg")
print(contact.email)contact, err := client.Contacts.Get(context.Background(), "con_123")
if err != nil {
log.Fatal(err)
}
fmt.Println(contact.Email)$contact = $bird->contacts->get('con_01krdgeqcxet5s7t44vh8rt9mg');
echo $contact->getEmail(), ' ', $contact->getFirstName();bird contacts get <contact-id>curl -X GET "https://us1.platform.bird.com/v1/contacts/{contact_id}" \
-H "Authorization: Bearer $TOKEN"{
"id": "con_01krdgeqcxet5s7t44vh8rt9mg",
"audiences": [
{
"id": "adn_01krdgeqcxet5s7t44vh8rt9mg"
}
],
"created_at": "2026-05-20T09:14:52Z",
"updated_at": "2026-05-25T16:42:01Z"
}
Returns a single contact, including its custom data values and the channels it can be reached on. To find a contact's ID by email address or external_id, use List contacts.
Parameters
contact_idstringID of the contact to fetch.
Response Payload
idID of the contact, accepted by every operation that takes a contact_id.
emailThe contact's email address, in its stored form, trimmed and lowercased before uniqueness is checked. Unique within the workspace. null when the contact has no email address.
phone_numberThe contact's phone number in normalized international form: a leading + and four to 15 digits. We normalize formatting but do not verify the number against numbering-plan metadata. The number is unique within the workspace. Because carriers recycle disconnected numbers, use external_id as the durable key for your own records. null when the contact has no phone number.
first_nameThe contact's first name. Available in broadcast templates as bird.contact.first_name.
last_nameThe contact's last name. Available in broadcast templates as bird.contact.last_name.
external_idYour own identifier for this contact, such as a user ID in your system. Unique within the workspace when set.
dataCustom property values for this contact, available in broadcast templates as bird.contact.<key>. Each key is a property created via the contact properties API, and each value is a string, number, boolean, or RFC 3339 datetime matching the property's declared type (strings up to 500 characters). Total size is capped at 2 KB serialized. Values stored under a property that was later archived remain readable here.
audiencesThe audiences this contact belongs to, most-recently-joined first. Only present when listing contacts; omitted from every other contact operation.
Show child attributes
audiences.idID of the referenced audience.
audiences.nameThe audience's display name.
created_atupdated_atRelated resources
Continue with the documentation, guides and examples for this topic.