Pagination & Filtering

All list endpoints in the Qwetty API support pagination and filtering.

Pagination

Use page and limit query parameters:

Code
GET /api/v1/chats?page=1&limit=10

Response metadata

Paginated responses include a meta object:

Code
{
  "data": [...],
  "meta": {
    "total": 142,
    "per_page": 20,
    "current_page": 1,
    "last_page": 8
  }
}

Searching

The search parameter is supported on the chats endpoint, where it matches the chat name, contact name, and contact phone number:

Code
GET /api/v1/chats?search=john

The contacts and messages endpoints do not currently accept a search parameter.

Sorting

List endpoints return results in a fixed order — most recently updated/created first. There are no sort or order query parameters.

Next steps

• Error Handling — Handle API errors
• Rate Limits — Request limits
• API Reference — Full endpoint documentation