Guides

Pagination

How list endpoints are paginated

All list endpoints return paginated results.

Query Parameters

Parameter	Default	Max	Description
`page`	1	—	Page number
`limit`	20	100	Items per page
`sort_by`	varies	—	Sort field
`sort_order`	`desc`	—	`asc` or `desc`

Response Format

{
  "data": [...],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 142,
      "totalPages": 8
    }
  }
}

Example

# Page 1
curl -H "Authorization: Bearer $KEY" \
  "https://api.smartmca.com/api/public/v1/deals?page=1&limit=10"

# Page 2
curl -H "Authorization: Bearer $KEY" \
  "https://api.smartmca.com/api/public/v1/deals?page=2&limit=10"

Tips

Start with page=1 and increment until page > totalPages
Use limit=100 for bulk exports
Sort by createdAt for consistent ordering during export