ODoddspapi
fixtures/odds

Fixture Odds CLV

Changed on

Get opening vs closing line values (OLV/CLV) for a fixture.

Lookup mode: required fixtureId + optional bookmakers OR optional oddsIds.

get/fixtures/odds/clv

Request

  • Base URL
    https://v5.oddspapi.io/en
  • URL
    https://v5.oddspapi.io/en/fixtures/odds/clv
  • Auth
    • API key in query parameter apiKey
    • or API key in header X-API-Key

Query parameters

fixtureIdstring required

Single fixture ID (e.g. id1400003171515924).

bookmakersstring nullable

Comma/space-separated bookmaker slugs (default: all).

oddsIdsstring nullable

Optional: comma/space-separated oddsIds to restrict the response.

Response

Returns FixtureClvResponse (fixture meta + OLV/CLV pairs)

fixtureIdstring required

Fixture identifier: {prefix}{sportId}{tournamentId}{nativeId} — see Core Concepts → ID structure.

reissuedFixtureIdstring nullable required

The fixture that replaced this one, when a cancelled fixture has been re-listed under a new id. null is the normal value: it is only ever populated on a cancelled fixture (status.statusId 3) whose replacement already exists in the feed, so permanent cancellations stay null, and a fixture can go from null to an id after you first saw it cancelled. One hop: if the replacement was itself cancelled, follow its own reissuedFixtureId.

previousFixtureIdstring nullable required

The inverse of reissuedFixtureId: the cancelled fixture this one replaced. Unlike the forward pointer this sits on a normal scheduled or live fixture, so a fixture carries its own history even if you never saw the cancelled one. null is the normal value. One hop and one predecessor at most — follow it repeatedly to walk back to the start of a chain, where a fixture postponed twice gives A → B → C and B carries both previousFixtureId: A and reissuedFixtureId: C. Cleared again if a postponement is reverted.

startTimeinteger required

Epoch seconds (UTC).

trueStartTimestring nullable

Actual start time (ISO 8601), once known — may differ from the scheduled startTime.

trueEndTimestring nullable

Actual end time (ISO 8601), once known.

scoresobject required

Score rows keyed by period (result, p1, …).

expectedPeriodsinteger nullable

Number of regular periods expected for this fixture — use it (with periodLength) to interpret period keys per sport/league.

periodLengthinteger nullable

Length of a regular period in minutes.

externalProvidersExternalProviders required
bookmakersobject

Per-bookmaker availability and freshness metadata. Only populated when the bookmakers query parameter is present on the request — otherwise {}. Contains only bookmakers that currently offer valid realtime odds for this fixture. Present on odds endpoints; omitted on CLV, historical-odds and settlement responses.

oddsClvOddsByBookmaker required

Changes

  • 9ca3a6a3c1e8Revision changes
    • breaking

      the response property //// became optional for the status

    • breaking

      added subschema #2 to the //// response property oneOf list for the response status

    • breaking

      the //// response's property type changed from object to no type for status

    • breaking

      the ///// response's property type changed from int null to integer null for status

    • breaking

      the ///// response's property type changed from int to integer for status

    • breaking

      the ///// response's property type changed from json null to object null for status

    • breaking

      removed the required property ///// from the response with the status

    • breaking

      removed the required property ///// from the response with the status

    • breaking

      removed the required property ///// from the response with the status

    • breaking

      removed the required property ///// from the response with the status

    • breaking

      removed the required property ///// from the response with the status

    • breaking

      removed the required property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property ///// from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property allOf[Fixture]/bookmakers/additionalProperties/staleOddsResponseCode deprecated

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status