Pagination

The API uses two pagination styles depending on the endpoint.

Offset pagination

Used by Search Projects and List Versions.

Pass page as a query parameter (default 1, max 100). Each page contains up to 25 items.

curl 'https://api.youvico.com/api/projects/:id/versions?page=2' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [...],
  "page": {
    "current": 2,
    "hasNext": true
  }
}

When hasNext is true, increment page to fetch the next set of results.

Cursor pagination

Used by List Comments and List Replies.

Each response includes next and prev cursors. Pass one of them on the next request to navigate forward or backward.

{
  "data": [...],
  "page": {
    "next": "MjAyNi0wNC0xMFQwODowMDowMC4wMDBa",
    "prev": null
  }
}

• A null cursor means there are no more results in that direction.
• Send only one of next or prev per request — sending both returns a 400 error.
• Treat cursor values as opaque strings. Do not parse or construct them.

curl 'https://api.youvico.com/api/versions/:id/comments?next=MjAyNi0wNC0xMFQwODowMDowMC4wMDBa' \
  -H 'Authorization: Bearer YOUR_API_KEY'