## List contacts

`GET /get-external-contacts`

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

### Query parameters

- `limit` (integer (1–100)) — Maximum number of contacts to return. Defaults to 100.

- `offset` (integer (≥ 0)) — Pagination offset. Defaults to 0.

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

**Request — cURL**

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

**Response — 200 OK**

```json
{
  "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 }
}
```