Retrieve

API Reference

Contacts

Get a contact

get/api/v2/contacts/{phone_number}

Retrieve a specific contact by phone number

Path Parameters

phone_numberstring

Returns

contactassignedToEmailstringcompanyNamestringcreated_atstringfirstNamestringlastNamestringphonestringsendblueNumberstringtagsarray of stringverifiedbooleanContact

optional

statusstring

optional

HTTPTypeScript

curl https://api.sendblue.co/api/v2/contacts/$PHONE_NUMBER \
    -H "sb-api-key-id: $SENDBLUE_API_API_KEY" \
    -H "sb-api-secret-key: $SENDBLUE_API_API_SECRET"

200 Example

{
  "contact": {
    "assignedToEmail": "[email protected]",
    "companyName": "Example Corp",
    "created_at": "2024-01-15T10:30:00Z",
    "firstName": "John",
    "lastName": "Doe",
    "phone": "+1234567890",
    "sendblueNumber": "+1987654321",
    "tags": [
      "customer",
      "vip"
    ],
    "verified": true
  },
  "status": "OK"
}