Pagination

List endpoints such as GET /contacts, GET /messages, and GET /conversations return paginated results. For performance, the API does not return large record sets in a single response.

Query parameters

Example request

curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.buzzbip.com/v1/contacts?limit=25"

Response format

{
  "data": [
    { "id": "cnt_abc123", "phone": "+21612345678", "firstName": "Walid" }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJpZCI6ImNudF9hYmMxMjMifQ"
  }
}

When hasMore is true, pass nextCursor as the cursor query parameter to fetch the next page.