Contactsv4

List contacts

GET/contacts

Lists contacts. Cursor pagination is the default. Supplying offset, q, tag, sort, or filter switches to offset pagination and includes pagination.total.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Query parameters

identifieroptionalstring

Filter to the contact owning this phone/email.

qoptionalstring

Case-insensitive search across contact names, identities, and tags.

tagoptionalstring

Case-insensitive tag filter.

sortoptionalstring

"recent""oldest""name_asc""name_desc"

filteroptionalstring

"none""has_tags""no_tags""inbound_last""outbound_last"

offsetoptionalinteger

Zero-based offset. Cannot be combined with cursor.

limitoptionalinteger

Maximum number of items to return per page. Must be between 1 and 200; defaults to 50. Combine with cursor to paginate.

cursoroptionalstring

Opaque pagination cursor. Pass the next_cursor value from a previous response to fetch the next page; omit it on the first request.

Returns

dataoptionalContact[]

Array of Contact

idoptionalstring

Contact id (ct_...).

nameoptionalstring | null

created_atoptionalinteger

tagsoptionalstring[]

last_message_timeoptionalinteger | null

last_directionoptionalstring | null

"inbound""outbound"null

last_textoptionalstring | null

last_statusoptionalstring | null

identitiesoptionalobject[]

Array of object

idoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business"

identifieroptionalstring

channel_idoptionalstring | null

created_atoptionalinteger

has_moreoptionalboolean

next_cursoroptionalstring | null

paginationoptionalobject

limitoptionalinteger

offsetoptionalinteger

totaloptionalinteger

Response codes

200A page of contacts

400The request was malformed — check the path, query parameters, and body.

401Your API key is missing or invalid. Pass it as a bearer token.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X GET https://api.blooio.com/v4/contacts?identifier=%2B15551234567&q=string&tag=vip&sort=recent&filter=none&offset=1&limit=50&cursor=string \

  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "data": [    {      "id": "ct_a1b2c3d4",      "name": "Jane Doe",      "created_at": 0,      "tags": [        "string"      ],      "last_message_time": 0,      "last_direction": "inbound",      "last_text": "string",      "last_status": "string",      "identities": [        {          "id": "obj_a1b2c3d4",          "channel_type": "blooio",          "identifier": "+15551234567",          "channel_id": "ch_a1b2c3d4",          "created_at": 0        }      ]    }  ],  "has_more": true,  "next_cursor": "string",  "pagination": {    "limit": 50,    "offset": 1,    "total": 3  }}