Copy page

Common Patterns

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

Parameter	Default	Description
page	1	Page number (1-indexed)
limit	10	Items per page

Response metadata

Paginated responses include a meta object:

Code
{
  "success": true,
  "data": [...],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 142
  }
}

Searching

Use the search parameter for text search:

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

Search is case-insensitive and matches against name, email, and other relevant fields.

Sorting

Use sort and order parameters:

Code
GET /api/v1/chats?sort=createdAt&order=desc

Parameter	Values	Default
sort	Field name	varies by endpoint
order	asc, desc	desc

Next steps

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