Blooio API Reference
Contacts

List contacts

List all contacts for the organization with optional search and pagination.

GET
/contacts

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token.

In: header

Query Parameters

limit?integer

Maximum number of items to return (1-200)

Default50
Range1 <= value <= 200
offset?integer

Number of items to skip

Default0
Range0 <= value
q?string

Search query (matches identifier or name)

sort?string

Sort order

Default"recent"
Value in"recent" | "oldest" | "name_asc" | "name_desc"

Response Body

application/json

application/json

curl -X GET "https://backend.blooio.com/v2/api/contacts"
{
  "contacts": [
    {
      "id": "string",
      "contact_id": "string",
      "identifier": "string",
      "name": "string",
      "type": "phone",
      "created_at": 0,
      "last_message_time": 0,
      "tags": [
        "string"
      ]
    }
  ],
  "pagination": {
    "limit": 0,
    "offset": 0,
    "total": 0
  }
}
{
  "error": "string",
  "status": 0
}