Skip to main content

​
GET /contact-books/:id/contacts

Returns contacts in the specified contact book. Supports pagination and search.

​
Authentication

JWT Bearer token (dashboard auth)

​
Query Parameters

ParameterTypeDefaultDescription
pagenumber1Page number
limitnumber50Results per page
searchstring—Filter by email or name

​
Response

{
  "success": true,
  "data": {
    "contacts": [
      {
        "id": "660e8400-e29b-41d4-a716-446655440000",
        "contact_book_id": "550e8400-e29b-41d4-a716-446655440000",
        "email": "jane@example.com",
        "first_name": "Jane",
        "last_name": "Doe",
        "subscribed": true,
        "properties": {
          "company": "Acme Inc"
        },
        "created_at": "2026-03-07T12:00:00Z",
        "updated_at": "2026-03-07T12:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 142,
      "totalPages": 3
    }
  }
}

​
Example

curl "https://app.usesendi.com/api/contact-books/BOOK_ID/contacts?page=1&limit=50&search=jane" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​
Errors

StatusErrorCause
404Contact book not foundInvalid book ID or not owned by user