List

API Reference

Contacts

Get contacts

get/api/v2/contacts

Retrieve a list of contacts for the authenticated account

Query Parameters

cidstring

optional

Filter by contact ID

limitnumber

optional

Maximum number of contacts to return

offsetnumber

optional

Number of contacts to skip

order_bystring

optional

Field to sort by

order_directionenum

optional

"asc" OR "desc"

Sort direction

Hide ParametersShow Parameters

"asc"

"desc"

phone_numberstring

optional

Filter by phone number

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

200 Example

[
  {
    "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
  }
]