Get odds for fixtures in a date range

Returns operator-enriched betting odds for fixtures starting within a date range (max 7 days), filtered by sport and optionally by competition and operators. Results are ordered by start time ascending and paginated. Fixtures whose odds are no longer served are omitted: those that are finished or cancelled, and those far enough past their start time that the stored status can no longer be trusted, so a date range wholly in the past returns an empty page. "meta.total" is an upper bound on the entries a page can hold: it is exact unless a fixture's stored odds and its match record disagree on the start time, which happens when a fixture is rescheduled. In that case a page can hold fewer than "limit" entries even though later pages exist, so page with "meta.total" (more pages remain while page * limit < total) rather than stopping at the first short page; the last page may be empty. Each operator entry carries a resolved event URL in "urls", a competition URL in "competition_urls", a per-selection URL under each selection's "urls", and an unresolved "betslip_url_template" the client fills with the user's selections joined by "betslip_id_separator". A level with no configured template is omitted.

Query Params
string

Affiliate ID substituted into {affiliate_id} URL placeholders

string

Comma-separated operator_id:affiliate_id pairs (e.g. betano_bg:aff-123,inbet_bg:aff-456); overrides affiliate_id for the listed operators

string
required

Client ID

string

Competition identifier (e.g. fb:c:1)

string
required

Start of the range (inclusive), ISO 8601 datetime

string
required

End of the range (inclusive), ISO 8601 datetime. Max range: 7 days

string
required

Client API key

string

BCP 47 language tag (e.g. EN, BG)

int32

Items per page. Defaults to 50, max 200

string

DECIMAL (default) or FRACTIONAL

string

Comma-separated operator ID filter (e.g. efbet-bg,betano_bg)

int32

Page number (1-based). Defaults to 1

string
required

Filter by sport: FOOTBALL, BASKETBALL, TENNIS, AMERICAN_FOOTBALL, FORMULA_1, HOCKEY

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json