List contacts

Returns the authenticated user's external contacts, newest first, with pagination. Pass phone to look up a single contact by number.

GET/get-external-contactsBearer token

Query parameters

limitinteger (1–100)

Maximum number of contacts to return. Defaults to 100.

offsetinteger (≥ 0)

Pagination offset. Defaults to 0.

phonestring

Look up a single contact by phone number (exact match after normalization to E.164).

Request

curl -G https://api.tryprojectblue.com/get-external-contacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "limit=25"

Response

200 OK

{
  "contacts": [
    {
      "id": "cmm4k2p1z0001s6ry9x8u7q3v",
      "firstName": "Jamie",
      "lastName": "Rivera",
      "phoneNumber": "+15551234567",
      "email": "jamie@example.com",
      "customFields": {
        "orderId": "ord_18342",
        "plan": "pro"
      },
      "note": null,
      "createdAt": "2026-08-14T17:22:05.118Z",
      "updatedAt": "2026-08-14T17:22:05.118Z"
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "total": 138 }
}