Recorded full-game prop checkpoints for one fixture

GET

/v1/historical/sports/{sport}/events/{id}/props

curl --request GET \
  --url 'https://oddslink.app/v1/historical/sports/nfl/events/nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20/props?markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&dateFormat=iso' \
  --header 'X-API-Key: <X-API-Key>'

• Production

Full-game player prop checkpoints recorded from capture activation onward. Requires Scale or Business. Scale covers fixtures starting in the last 2 years. Use aggregate soccer or tennis keys; league and tournament selectors are rejected. Every player, stat, line and side is preserved. Openers are the first observation of each individual selection; closing prices must be observed before kickoff with a fresh source timestamp. No earlier prop prices are reconstructed. Coverage distinguishes recorded, observed_empty, failed and not_recorded. Halves and quarters are not archived.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

sport

required

string

A historical sport key: nfl, ncaaf, nba, wnba, mlb, nhl, mma, aggregate soccer or aggregate tennis. nhl and mlb serve the same franchise fixtures as their live routes. A soccer league key such as epl serves fixtures with a recorded league matching that key, including older fixtures. Fixtures without a recorded league are served by the aggregate soccer key only. An event outside the key’s league answers 404 UNKNOWN_EVENT, like an unknown ID. League and tournament query selectors are rejected with 400 BAD_REQUEST. Tournament-specific tennis_* keys are not supported by history. Esports history also accepts cs2, lol, dota2, valorant, from the start of recording; earlier esports prices are not backfilled.

Example

nfl

id

required

string

A fixture id, as returned by GET /v1/sports/{sport}/events. Treat as opaque.

Example

nfl:atlantafalcons-carolinapanthers:2026-09-20

Query Parameters

storedCommenceTime

string

Select an exact stored listed kickoff from error.stored_commence_times or historical discovery. ISO with timezone or Unix seconds. Required when multiple eligible stored kickoffs remain. Empty duplicate kickoffs are not choices when another kickoff has recorded prices; selecting one returns INVALID_STORED_COMMENCE_TIME. Entirely empty tracked fixtures remain selectable. No archival prices are rewritten.

markets

required

string

Comma-separated player-prop market keys, with no period in them, for example player_pass_yds or player_anytime_td; choose periods with periods. Required: there is no default set of props. Discover the full catalogue via /v1/markets. Tennis includes player_aces, player_break_points_won, player_games_won, player_total_games, player_total_sets, player_total_tiebreaks and player_fantasy_points. MMA includes player_significant_strikes, player_takedowns, player_fight_time_minutes (decimal minutes), player_knockdowns, player_control_time_minutes (decimal minutes), player_submission_attempts, player_significant_body_strikes, player_significant_leg_strikes and player_fantasy_points. Fantasy scoring follows the offering book’s rules. These tennis/MMA props use full-game periods.

Example

player_anytime_td,player_pass_yds

periods

string

Comma-separated periods for the requested markets: 1h, 2h (halves), 1q..4q (quarters), 1p..3p (hockey periods), f5 (baseball first 5 innings), 1i (baseball first inning), 1s..5s (tennis sets), reg (hockey regulation time). Omitting it returns the full game only. full asks for the full game beside other periods (periods=full,1h); it is accepted here only, since a full-game market carries no period. all returns the full game and every period. An unknown period is 422 INVALID_MARKET. There are no F3 or F7 markets. Esports also accepts map1, map2, map3, map4, map5; use periods=full,map1 for full-match and first-map prices.

Example

full,1h

bookmakers

string

Comma-separated, case-sensitive book keys from /v1/bookmakers. A typo or wrong case returns 422 INVALID_BOOKMAKER with a suggested key and valid_bookmakers; it does not count against your allowance. Defaults to every book when omitted. On the odds and props routes, any book you name that returns no markets for a fixture is listed in that fixture’s unmatched_bookmakers.

Example

draftkings,fanduel

oddsFormat

string

default: american

Allowed values: american decimal

One number per price.

dateFormat

string

default: iso

Allowed values: iso unix

How commence_time, every last_update and recorded_at, and archive_from are written: ISO-8601 UTC strings with exactly three fractional digits and trailing Z (iso, e.g. 2026-10-11T13:00:00.000Z) or unix seconds (unix). ISO sub-millisecond digits are truncated. Unix price clocks may be fractional; fixture and gameline archive times use whole seconds.

Responses

200

Recorded full-game prop checkpoints for one fixture.

Media typeapplication/json

object

id

required

A readable, constructible fixture id. Treat as opaque.

string

sport_key

required

string

sport_title

required

string

commence_time

required

Any of:

string

ISO-8601 UTC with exactly three fractional digits and a trailing Z.

string format: date-time

integer

Seconds since 1970-01-01T00:00:00.000Z.

integer

is_live

required

true from scheduled commence_time until the sport-specific live-window cutoff; false outside that window. Inferred from time, not a confirmed match-status or final-result feed, except reliable source terminal evidence makes it false. See the additive status and status_evidence fields. A delayed start, early finish or unusually long fixture can disagree with this flag. Evaluated when the response is served, so it can flip without a price change. On the WebSocket feed a flip arrives as a status upsert. Historical routes apply the same time-derived rule.

boolean

status

required

On current fixture routes, scheduled means the fixture has not started, including a delayed start. Live requires is_live to be true and a fresh observation of a linked book’s own in-play state, identified by status_evidence. Unknown means neither live play nor finish is confirmed. Finished requires retained explicit terminal evidence. These values are additive; clients must accept new values. Historical props use their separately documented recording status. Archive presence and absent prices alone never prove finish.

string

score

Present only for covered live soccer and tennis fixtures with a fresh observation. All sides follow home_team and away_team. Soccer clocks are cumulative observed match time, without extrapolation. Tennis totals count completed sets; ambiguous totals are omitted. Uncovered or stale scores are absent.

object

home

integer

away

integer

period

string

clock

string

sets

Array<object>

object

home

required

integer

away

required

integer

points

object

home

string

away

string

serving

string

updated_at

Any of:

string

ISO-8601 UTC with exactly three fractional digits and a trailing Z.

string format: date-time

number

Seconds since 1970-01-01T00:00:00.000Z, optionally fractional for measured prices.

number

status_evidence

The book, its observed state and observation time supporting live or finished status. Absent when no supporting observation is available.

object

bookmaker

required

string

state

required

string

observed_at

required

Any of:

string

ISO-8601 UTC with exactly three fractional digits and a trailing Z.

string format: date-time

number

Seconds since 1970-01-01T00:00:00.000Z, optionally fractional for measured prices.

number

home_team

required

string

away_team

required

string

league

Soccer fixtures only: the league a fixture belongs to. key is the public sport key when the league has one (epl; pass it as soccer?league= or as the sport key), else a stable key for that league; title is its display name. null when the league is not known for the fixture. Historical bodies carry the same object; a fixture archived before its league was recorded has league: null unless the sport key you asked with names one (epl). Other sports carry no league (tennis and esports carry tournament; every other sport key is one league).

object

key

required

string

title

required

string

tournament

Tennis and esports fixtures: the tournament a match belongs to. key is the tournament’s public sport key (tennis_atp_hangzhou; pass it as tennis?tournament= or as the sport key); title is its display name. null when the tournament is not known. Historical bodies carry the same object. For esports, key identifies the tournament within the requested game and is accepted by tournament= on events and odds lists.

object

key

required

string

title

required

string

best_of

Esports series format. Present only when known and the books agree; absent when unknown. A BO2 Draw is represented by h2h_3_way independently of this field.

integer

Allowed values: 1 3 5

capture_started_at

required

Any of:

unknown

Any of:

string

ISO-8601 UTC with exactly three fractional digits and a trailing Z.

string format: date-time

number

Seconds since 1970-01-01T00:00:00.000Z, optionally fractional for measured prices.

number

null

null

status

required

string

props

required

Array

object

bookmaker

required

object

key

required

string

title

required

string

link

A link to this fixture on the bookmaker’s own website. Present only when the bookmaker gives one; the field is absent otherwise, never empty or null. Some bookmakers link to the competition page rather than the single event. This is an event-page link; it does not select an outcome or populate a bet slip.

string format: uri

last_update

required

Any of:

unknown

Any of:

string

ISO-8601 UTC with exactly three fractional digits and a trailing Z.

string format: date-time

number

Seconds since 1970-01-01T00:00:00.000Z, optionally fractional for measured prices.

number

null

null

player

required

string

stat

required

A player-prop market key, with no period in it, for example player_pass_yds.

string

period

The slice of the game a market settles on: 1h/2h halves, 1q..4q quarters, 1p..3p hockey periods, f5 baseball’s first 5 innings, 1i baseball’s first inning, 1s..5s tennis sets, reg hockey regulation time. Absent on a full-game market; never full. More periods may be added. There are no F3 or F7 markets. Esports map periods are map1 through map5; full-match markets omit the period field.

string

point

The line for this stat. Absent for a binary (Yes/No) prop.

number

points

required

Array<object>

object

checkpoint

required

string

status

required

string

main

Movement points only. Whether this line was the book’s main line for the player and stat at that instant.

boolean

recorded_at

required

Any of:

string

ISO-8601 UTC with exactly three fractional digits and a trailing Z.

string format: date-time

number

Seconds since 1970-01-01T00:00:00.000Z, optionally fractional for measured prices.

number

outcomes

required

Array

>= 1 items

object

name

required

Over, Under, Yes or No today. More sides may be added.

string

payout_multiplier

Underdog’s published multiplier for this exact pick, passed through as a number. Optional and omitted when unavailable; never null or inferred from an entry payout. Independent of oddsFormat. Available only on Underdog outcomes.

number

price

Any of:

integer

American odds: an integer of +100 or more, or -100 or less (124, -110). Never between -100 and +100, and never fractional.

integer

>= -99 <= 99

number

Decimal odds, the total return per unit staked, stake included (1.91).

number

> 1

size

object

kind

required

posted_limit: one number that applies to both legs, a sportsbook’s maximum bet. resting_depth: a separate number per leg, an exchange’s live order book. contracts: a contract count; no bookmaker uses it today (Kalshi and Polymarket report resting_depth in dollars at the best price). More kinds may be added. The kind is fixed per bookmaker (GET /v1/bookmakers size_kind).

string

amount

required

Always a positive number. A posted_limit or resting_depth amount is in the bookmaker’s own currency; a contracts amount is a count. The same object appears on every line the bookmaker states a size for, including alternate lines and periods.

number

fair_prob

With devig: the probability of this outcome after the margin is removed from its complete set of sides (see the devig parameter for the method). Absent, never null or 0, when the set is incomplete, crossed or a stub.

number

<= 1

fair_price

With devig: fair_prob as a price, in the request’s oddsFormat (an integer in American, three decimals in decimal).

number

net_price

With fees: the price after the venue’s taker fee, in the request’s oddsFormat (an integer in American, three decimals in decimal). Present only on a venue and date with a published schedule; see the market’s fees object. A commission venue’s figure is the price if the bet wins.

number

last_update

required

Any of:

string

ISO-8601 UTC with exactly three fractional digits and a trailing Z.

string format: date-time

number

Seconds since 1970-01-01T00:00:00.000Z, optionally fractional for measured prices.

number

coverage

required

Array<object>

object

book

string

checkpoint

string

status

string

observed_ts

Any of:

string

ISO-8601 UTC with exactly three fractional digits and a trailing Z.

string format: date-time

number

Seconds since 1970-01-01T00:00:00.000Z, optionally fractional for measured prices.

number

stat

string

reason

string

unmatched_bookmakers

required

Array<string>

Examples

Examplerecorded

Illustrative recorded prop checkpoints, not proof of fixture coverage

{
  "id": "nfl:atlantafalcons-carolinapanthers:2026-10-04",
  "sport_key": "nfl",
  "sport_title": "NFL",
  "commence_time": "2026-10-04T17:00:00.000Z",
  "is_live": false,
  "home_team": "Atlanta Falcons",
  "away_team": "Carolina Panthers",
  "capture_started_at": "2026-10-04T16:00:00.000Z",
  "status": "recorded",
  "props": [
    {
      "bookmaker": {
        "key": "draftkings",
        "title": "DraftKings",
        "last_update": "2026-10-04T16:59:40.125Z"
      },
      "player": "Example Quarterback",
      "stat": "player_pass_yds",
      "point": 249.5,
      "points": [
        {
          "checkpoint": "close",
          "status": "recorded",
          "recorded_at": "2026-10-04T16:59:41.250Z",
          "outcomes": [
            {
              "name": "Over",
              "price": -110,
              "last_update": "2026-10-04T16:59:40.125Z"
            },
            {
              "name": "Under",
              "price": -110,
              "last_update": "2026-10-04T16:59:40.125Z"
            }
          ]
        }
      ]
    }
  ],
  "coverage": [],
  "unmatched_bookmakers": []
}

Headers

x-requests-used

integer

Requests used this billing period.

x-requests-remaining

integer

Requests remaining this billing period.

x-requests-last

integer

What this one call cost against the allowance (0 for a free call).

X-RateLimit-Limit

integer

This plan’s speed limit, in requests per second.

X-RateLimit-Remaining

integer

Requests left in the current one-second window.

X-RateLimit-Reset

integer

Seconds until the speed-limit window resets.

X-Request-Id

string

This request’s id, for support and for matching against error.request_id.

400

A parameter was malformed.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

docs_url

required

string format: uri

request_id

required

string

stored_commence_times

Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.

Array<integer>

valid_bookmakers

Valid case-sensitive book keys on INVALID_BOOKMAKER.

Array<string>

current_plan

403 only: the plan on the presented key.

string

required_plan

403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.

string

Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "commenceTimeFrom is not a valid ISO-8601 timestamp.",
    "docs_url": "https://oddslink.app/docs/errors/#bad-request",
    "request_id": "req_01hz8k3z9e2v6w1x"
  }
}

Headers

x-requests-used

integer

Requests used this billing period.

x-requests-remaining

integer

Requests remaining this billing period.

x-requests-last

integer

What this one call cost against the allowance (0 for a free call).

X-RateLimit-Limit

integer

This plan’s speed limit, in requests per second.

X-RateLimit-Remaining

integer

Requests left in the current one-second window.

X-RateLimit-Reset

integer

Seconds until the speed-limit window resets.

X-Request-Id

string

This request’s id, for support and for matching against error.request_id.

401

The X-API-Key header is missing or invalid.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

docs_url

required

string format: uri

request_id

required

string

stored_commence_times

Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.

Array<integer>

valid_bookmakers

Valid case-sensitive book keys on INVALID_BOOKMAKER.

Array<string>

current_plan

403 only: the plan on the presented key.

string

required_plan

403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.

string

Examples

No X-API-Key header sent

{
  "error": {
    "code": "MISSING_KEY",
    "message": "X-API-Key header is missing.",
    "docs_url": "https://oddslink.app/docs/errors/#missing-key",
    "request_id": "req_01hz8k4a1f3w7x2y"
  }
}

Key does not exist or was revoked

{
  "error": {
    "code": "INVALID_KEY",
    "message": "API key is not valid.",
    "docs_url": "https://oddslink.app/docs/errors/#invalid-key",
    "request_id": "req_01hz8k4b2g4x8y3z"
  }
}

Headers

x-requests-used

integer

Requests used this billing period.

x-requests-remaining

integer

Requests remaining this billing period.

x-requests-last

integer

What this one call cost against the allowance (0 for a free call).

X-RateLimit-Limit

integer

This plan’s speed limit, in requests per second.

X-RateLimit-Remaining

integer

Requests left in the current one-second window.

X-RateLimit-Reset

integer

Seconds until the speed-limit window resets.

X-Request-Id

string

This request’s id, for support and for matching against error.request_id.

403

The key’s plan does not include history (Scale plan and up), or does not reach back to this fixture: Scale covers fixtures that started in the last 2 years, Business covers everything recorded.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

docs_url

required

string format: uri

request_id

required

string

stored_commence_times

Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.

Array<integer>

valid_bookmakers

Valid case-sensitive book keys on INVALID_BOOKMAKER.

Array<string>

current_plan

403 only: the plan on the presented key.

string

required_plan

403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.

string

Examples

History is not on this plan

{
  "error": {
    "code": "PLAN_REQUIRED",
    "message": "History requires the Scale plan or above.",
    "docs_url": "https://oddslink.app/docs/errors/#plan-required",
    "request_id": "req_01hz8k4c4j6z0a5b",
    "current_plan": "growth",
    "required_plan": "scale"
  }
}

This fixture is older than the plan's 2-year window

{
  "error": {
    "code": "PLAN_REQUIRED",
    "message": "The Scale plan covers fixtures that started in the last 2 years. This one started 2024-09-02; the Business plan covers everything recorded.",
    "docs_url": "https://oddslink.app/docs/errors/#plan-required",
    "request_id": "req_01hz8k4c5k7a1b6c",
    "current_plan": "scale",
    "required_plan": "business"
  }
}

Headers

x-requests-used

integer

Requests used this billing period.

x-requests-remaining

integer

Requests remaining this billing period.

x-requests-last

integer

What this one call cost against the allowance (0 for a free call).

X-RateLimit-Limit

integer

This plan’s speed limit, in requests per second.

X-RateLimit-Remaining

integer

Requests left in the current one-second window.

X-RateLimit-Reset

integer

Seconds until the speed-limit window resets.

X-Request-Id

string

This request’s id, for support and for matching against error.request_id.

404

The sport key, or the fixture id within it, does not exist.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

docs_url

required

string format: uri

request_id

required

string

stored_commence_times

Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.

Array<integer>

valid_bookmakers

Valid case-sensitive book keys on INVALID_BOOKMAKER.

Array<string>

current_plan

403 only: the plan on the presented key.

string

required_plan

403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.

string

Examples

No fixture with this id under this sport key

{
  "error": {
    "code": "UNKNOWN_EVENT",
    "message": "Unknown fixture id for nfl: nfl:atlantafalcons-carolinapanthers:2026-09-27",
    "docs_url": "https://oddslink.app/docs/errors/#unknown-event",
    "request_id": "req_01hz8k4d6m8b2c7d"
  }
}

Sport key does not exist

{
  "error": {
    "code": "UNKNOWN_SPORT",
    "message": "Unknown sport key: basketbal_nba",
    "docs_url": "https://oddslink.app/docs/errors/#unknown-sport",
    "request_id": "req_01hz8k4d7n9c3d8e"
  }
}

Headers

x-requests-used

integer

Requests used this billing period.

x-requests-remaining

integer

Requests remaining this billing period.

x-requests-last

integer

What this one call cost against the allowance (0 for a free call).

X-RateLimit-Limit

integer

This plan’s speed limit, in requests per second.

X-RateLimit-Remaining

integer

Requests left in the current one-second window.

X-RateLimit-Reset

integer

Seconds until the speed-limit window resets.

X-Request-Id

string

This request’s id, for support and for matching against error.request_id.

422

A parameter was well-formed but not valid (an unknown market or bookmaker key, for example).

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

docs_url

required

string format: uri

request_id

required

string

stored_commence_times

Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.

Array<integer>

valid_bookmakers

Valid case-sensitive book keys on INVALID_BOOKMAKER.

Array<string>

current_plan

403 only: the plan on the presented key.

string

required_plan

403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.

string

Example

{
  "error": {
    "code": "INVALID_MARKET",
    "message": "Invalid markets: not_a_market",
    "docs_url": "https://oddslink.app/docs/errors/#invalid-market",
    "request_id": "req_01hz8k4e5k7a1b6c"
  }
}

Headers

x-requests-used

integer

Requests used this billing period.

x-requests-remaining

integer

Requests remaining this billing period.

x-requests-last

integer

What this one call cost against the allowance (0 for a free call).

X-RateLimit-Limit

integer

This plan’s speed limit, in requests per second.

X-RateLimit-Remaining

integer

Requests left in the current one-second window.

X-RateLimit-Reset

integer

Seconds until the speed-limit window resets.

X-Request-Id

string

This request’s id, for support and for matching against error.request_id.

429

Either the plan’s speed limit or its monthly allowance was exceeded. error.code tells you which. Only the calls that count against the allowance can answer ALLOWANCE_SPENT.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

docs_url

required

string format: uri

request_id

required

string

stored_commence_times

Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.

Array<integer>

valid_bookmakers

Valid case-sensitive book keys on INVALID_BOOKMAKER.

Array<string>

current_plan

403 only: the plan on the presented key.

string

required_plan

403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.

string

Examples

Too many requests this second (Retry-After is set)

{
  "error": {
    "code": "SPEED_LIMIT",
    "message": "Speed limit exceeded: 10 requests/second on the Growth plan.",
    "docs_url": "https://oddslink.app/docs/errors/#speed-limit",
    "request_id": "req_01hz8k4f6l8b2c7d"
  }
}

The month's allowance is used up

{
  "error": {
    "code": "ALLOWANCE_SPENT",
    "message": "Monthly allowance of 100000 requests used. Resets 2026-10-01.",
    "docs_url": "https://oddslink.app/docs/errors/#allowance-spent",
    "request_id": "req_01hz8k4g7m9c3d8e"
  }
}

Headers

x-requests-used

integer

Requests used this billing period.

x-requests-remaining

integer

Requests remaining this billing period.

x-requests-last

integer

What this one call cost against the allowance (0 for a free call).

X-RateLimit-Limit

integer

This plan’s speed limit, in requests per second.

X-RateLimit-Remaining

integer

Requests left in the current one-second window.

X-RateLimit-Reset

integer

Seconds until the speed-limit window resets.

X-Request-Id

string

This request’s id, for support and for matching against error.request_id.

Retry-After

integer

Seconds to wait before retrying on 429 SPEED_LIMIT or 503 ODDS_UNAVAILABLE.

503

No built prices are available yet. Retry after the indicated number of seconds.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

docs_url

required

string format: uri

request_id

required

string

stored_commence_times

Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.

Array<integer>

valid_bookmakers

Valid case-sensitive book keys on INVALID_BOOKMAKER.

Array<string>

current_plan

403 only: the plan on the presented key.

string

required_plan

403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.

string

Example

{
  "error": {
    "code": "ODDS_UNAVAILABLE",
    "message": "No built prices are available yet.",
    "docs_url": "https://oddslink.app/docs/errors/#odds-unavailable",
    "request_id": "req_example"
  }
}

Headers

<<

Retry-After

integer

Seconds to wait before retrying on 429 SPEED_LIMIT or 503 ODDS_UNAVAILABLE.

5XX

Something failed on our side.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

docs_url

required

string format: uri

request_id

required

string

stored_commence_times

Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.

Array<integer>

valid_bookmakers

Valid case-sensitive book keys on INVALID_BOOKMAKER.

Array<string>

current_plan

403 only: the plan on the presented key.

string

required_plan

403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.

string

Example

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Something went wrong on our side. It has been logged.",
    "docs_url": "https://oddslink.app/docs/errors/#internal-error",
    "request_id": "req_01hz8k4h8n0d4e9f"
  }
}

Headers

x-requests-used

integer

Requests used this billing period.

x-requests-remaining

integer

Requests remaining this billing period.

x-requests-last

integer

What this one call cost against the allowance (0 for a free call).

X-RateLimit-Limit

integer

This plan’s speed limit, in requests per second.

X-RateLimit-Remaining

integer

Requests left in the current one-second window.

X-RateLimit-Reset

integer

Seconds until the speed-limit window resets.

X-Request-Id

string

This request’s id, for support and for matching against error.request_id.