Pagination

All list endpoints (/wins, /spaces, /tags) support pagination.

Query parameters

Parameter	Type	Default	Range	Description
page	integer	1	1+	Page number
per_page	integer	25	1–100	Items per page

Response headers

Pagination metadata is returned in response headers:

Header	Type	Description
X-Total-Count	integer	Total number of records matching the query
X-Page	integer	Current page number
X-Per-Page	integer	Items per page

Example

Request

curl "https://app.myhypedoc.com/api/v1/wins?page=2&per_page=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response headers

X-Total-Count: 47
X-Page: 2
X-Per-Page: 10

The response body contains items 11–20 of 47 total.

Calculating pages

To determine the total number of pages:

total_pages = ceil(X-Total-Count / X-Per-Page)

For the example above: ceil(47 / 10) = 5 pages.

Notes

• page values below 1 are clamped to 1
• per_page values are clamped to the range 1–100
• Requesting a page beyond the last page returns an empty array
• The default per_page of 25 works well for most use cases