Pagination & Filtering

List endpoints across the SportQuanta API share a common set of query parameters. Learn them once and they apply everywhere.

Pagination

Lists use opaque cursor pagination.

Param	Type	Notes
`limit`	int	Items per page. Default `25`, maximum `200`.
`cursor`	opaque	Page cursor returned by the previous response. Omit for the first page.

Pass the cursor from the previous response back as ?cursor= to fetch the next page. Treat the cursor as opaque — don’t parse or construct it yourself.

# First page
curl "https://api.sportquanta.com/v1/mlb/games?date=2026-06-29&limit=50" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

# Next page
curl "https://api.sportquanta.com/v1/mlb/games?date=2026-06-29&limit=50&cursor=OPAQUE_CURSOR" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Common filters

Most game/match list endpoints accept:

Param	Type	Notes
`date`	`YYYY-MM-DD`	Filter to a scheduled date.
`date_from` / `date_to`	`YYYY-MM-DD`	Date range bounds.
`season`	int	League-specific season identifier.
`team_id`	string	Restrict to games involving a team.
`status`	enum	`scheduled` · `live` · `final` · `postponed`.

Odds & props filters

Where odds or props are returned:

Param	Notes
`bookmaker`	CSV of bookmaker ids, e.g. `?bookmaker=draftkings,fanduel`. Default: all integrated books.
`market`	CSV of prop-market codes, e.g. `?market=points,rebounds`.
`since` / `until`	ISO-8601 timestamps bounding history endpoints.

Soccer filters

Param	Notes
`competition`	Filter to a specific competition id (alias: `competitionId`).
`stage`	`group`, `round-of-16`, `final`, etc.

Embedding sub-resources

Some fixture endpoints accept include to embed related data in one call and avoid a follow-up request:

curl "https://api.sportquanta.com/v1/epl/matches/MATCH_ID?include=odds" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Provenance

Append ?provenance=true to any data endpoint to include source, ingestion run, and ingested_at metadata under _meta.provenance. This is useful when auditing where a value came from. It does not affect billing.

Get Started

Core Concepts

Pagination & Filtering

Common filters

Odds & props filters

Soccer filters

Embedding sub-resources

Provenance

​Pagination

​Common filters

​Odds & props filters

​Soccer filters

​Embedding sub-resources

​Provenance

Pagination

Common filters

Odds & props filters

Soccer filters

Embedding sub-resources

Provenance