Games & Live Scores

Extended play context

Provider passing/running classifications and scalar distances. Requires stats entitlement. Private, no-store; NFL_EVENT_CONTEXT_API_ENABLED=false disables this new route. Legacy play responses remain unchanged. Availability requires separate enrichment and verified existing game identities. No player routes, continuous positions or tracking are inferred.

GEThttps://api.sportquanta.com/v1/nfl/games/{id}/pbp/extended

Reference context: NFL.

Overview · Response conventions

curl --request GET \
  --url 'https://api.sportquanta.com/v1/nfl/games/{id}/pbp/extended' \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "game_id": "<string>",
    "season": 0,
    "producer": "nflverse_event_context",
    "observed_at": "2026-10-29T00:00:00Z",
    "source_url": "<string>",
    "schema_version": 1,
    "revision": "<string>",
    "events": [
      {
        "source_event_id": "<string>",
        "source_play_id": 0,
        "quarter": 0,
        "clock": "<string>",
        "play_type": "<string>",
        "pass_length": "<string>",
        "pass_location": "<string>",
        "air_yards": 0,
        "yards_after_catch": 0,
        "run_location": "<string>",
        "run_gap": "<string>",
        "shotgun": true,
        "no_huddle": true
      }
    ],
    "measurement_definitions": {
      "source": "<string>",
      "distances": "<string>",
      "classifications": "<string>",
      "order": "<string>"
    },
    "coverage": {
      "complete": null,
      "tracking_available": false
    },
    "next_cursor": "<string>"
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Path Parameters

idstringrequired

Canonical NFL game ID.

Query Parameters

seasonintegerdefault:0

1999 through 2100, or 0/omitted for the latest stored season. Values 1 through 1998 are rejected.

Required range: 0 <= x, x <= 2100

limitintegerdefault:50

Required range: 1 <= x, x <= 100

cursorstring

Opaque next_cursor from this game and source revision. A malformed cursor or revised snapshot returns 400; restart without cursor.

Response

application/json

Stored provider context and explicit coverage.

dataobject

Independent NFL event context. Empty or unavailable source observations do not imply zero production coverage.

data.game_idstringrequired

Existing canonical game ID.

data.seasonintegerrequired

Provider season year.

data.producer"nflverse_event_context"required

data.observed_atstring<date-time>required

Time the source snapshot was observed.

data.source_urlstring<uri>required

Source season CSV archive URL.

data.schema_version1required

data.revisionstringrequired

Opaque snapshot revision bound to this canonical game. Corrections invalidate old cursors.

data.eventsobject[]required

Provider events in numeric source-play order. Final duplicate occurrence wins; deleted source plays are excluded.

data.events.source_event_idstring

Verified nflverse game_id:play_id; used for exact legacy-play identity joins.

data.events.source_play_idinteger

Numeric provider play ID; stable ordering key within the source snapshot.

Required range: 0 <= x

data.events.quarterinteger | null

Provider quarter, including overtime when reported.

data.events.clockstring | null

Provider game clock; not an occurrence timestamp.

data.events.play_typestring | null

Provider play classification.

data.events.pass_lengthstring | null

Provider pass length classification; for example short or deep.

data.events.pass_locationstring | null

Provider pass direction; for example left, middle or right.

data.events.air_yardsnumber | null

Provider-reported yards travelled by the pass; negative values retained.

data.events.yards_after_catchnumber | null

Provider-reported yards after catch; negative values retained.

data.events.run_locationstring | null

Provider run direction; no inferred XY location.

data.events.run_gapstring | null

Provider run gap classification.

data.events.shotgunboolean | null

Provider formation flag; unknown remains null.

data.events.no_huddleboolean | null

Provider no-huddle flag; unknown remains null.

data.measurement_definitionsobjectrequired

Definitions accompany each snapshot.

data.measurement_definitions.sourcestring

Provider dictionary URL.

data.measurement_definitions.distancesstring

Distance units and meaning.

data.measurement_definitions.classificationsstring

Provider classification scope.

data.measurement_definitions.orderstring

Event ordering and duplicate handling.

data.coverageobjectrequired

Unknown completeness is not complete coverage.

data.coverage.completenull

Full-game completeness is not established.

data.coverage.tracking_availablefalse

data.next_cursorstring | nullrequired

Opaque continuation bound to game and revision; null at end. Restart without cursor after a source revision error.

_metaobject

Response request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.

_meta.request_idstring

_meta.served_fromenum<string>

Available options: live, cache

_meta.cache_ttl_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.