Pagination

Endpoints that return multiple items are properly paginated. You can control pagination with these query parameters:

Parameter	Description	Default
`page`	Which page to fetch (starts at 1)	`1`
`pageSize`	Items per page (5–100)	`20`

curl "https://app.useomnia.com/api/v1/brands?page=2&pageSize=20" \\
-H "Authorization: Bearer ot_your-token-here"

All paginated responses include page and navigation info alongside the results:

{
  "data": [
    { "id": "brand_abc", "name": "Brand A" },
    { "id": "brand_def", "name": "Brand B" }
  ],
  "pagination": {
    "page": 2,
    "pageSize": 20,
    "totalItems": 85
  },
  "links": {
    "prev": "https://app.useomnia.com/api/v1/brands?page=1&pageSize=20",
    "next": "https://app.useomnia.com/api/v1/brands?page=3&pageSize=20"
  }
}

Use the URLs in links to move between pages rather than building them yourself.