/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API API Reference Pagination

Pagination

How list endpoints paginate results in the Syntext API.

1 min read

List Builds accepts page and pageSize query parameters and returns a pagination object alongside the data. Other lists use the styles in the table below.

Request

NameDescription
page:integerquery
The page number, starting at 1.
Default1
pageSize:integerquery
Items per page, up to 100.
Default20
bash
curl "https://api.syntext.dev/v1/projects/$PROJECT_ID/builds?page=2&pageSize=50" \
-H "Authorization: Bearer $SYNTEXT_API_KEY"

Response

json
{
"data": [
{ "id": "bld_123", "status": "deployed", "...": "..." }
],
"pagination": {
"page": 2,
"pageSize": 50,
"total": 137
}
}

Results are ordered newest first. To fetch everything, increment page until page × pageSize reaches total.

Paginated Endpoints

•
List Builds — page, pageSize

Other lists use other styles:

StyleEndpoints
limit and offset, with a top-level totalDocumentation gaps, glossary (meta.total; without limit every term is returned)
Cursor — startingAfter and a top-level hasMoreList Invoices
limit only, newest firstRun history, access logs
Fixed — the 10 most recentPlayground history
page and limit, with top-level hasMore and totalAudit log
Note

Endpoints with naturally bounded result sets (projects, API keys, domains, audiences, page feedback, discussions) return all items without pagination.

Was this page helpful? Yes No
Previous
Product
Resources
Company
© 2026 SyntextBuilt with Syntext