Games

Schedule list for the given league. Soccer leagues also expose this as /v1/{league}/matches. Cursor-paginated; default limit 25, max 200.

Sport-specific filters: week applies to NFL only (regular-season weeks 1–18; postseason weeks 1–4); game_type applies to NHL only (preseason | regular | postseason | all-star | other). Both are accepted on every league and ignored by the sports that don't use them.

Baseball leagues (mlb, kbo, npb) also support date ranges via date_from / date_to and duplicate-safe upcoming lists via upcoming=true, for example /v1/npb/games?team_id=npb-SF&upcoming=true&limit=10. If date is supplied it wins over date_from / date_to.

Requires the odds entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/{league}/gamesTry it

GETList games / matches in a league

GEThttps://api.sportquanta.comhttps://api-stage.sportquanta.comhttp://localhost:8082/v1/{league}/games

Send

List games / matches in a league

Expand optional fieldsCollapse optional fields

Schedule list for the given league. Soccer leagues also expose this as /v1/{league}/matches. Cursor-paginated; default limit 25, max 200.

Sport-specific filters: week applies to NFL only (regular-season weeks 1–18; postseason weeks 1–4); game_type applies to NHL only (preseason | regular | postseason | all-star | other). Both are accepted on every league and ignored by the sports that don't use them.

Baseball leagues (mlb, kbo, npb) also support date ranges via date_from / date_to and duplicate-safe upcoming lists via upcoming=true, for example /v1/npb/games?team_id=npb-SF&upcoming=true&limit=10. If date is supplied it wins over date_from / date_to.

Requires the odds entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

Authorization

Authorizationstringheaderrequired

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

Bearer

Path

Query

datestring

Exact schedule date. Overrides date_from / date_to.

date_fromstring

Inclusive schedule-date bound (YYYY-MM-DD), supported across sports. Ignored when date is supplied.

date_tostring

Inclusive schedule-date bound (YYYY-MM-DD), supported across sports. Ignored when date is supplied.

seasonstring

League-specific stored season. Soccer uses an exact string match. Basketball accepts a start year or supported cross-year label; baseball/NFL/NHL parse a year.

weekinteger

NFL-only week filter; ignored by other leagues.

team_idstringstatusstring

Exact, case-sensitive stored status. Use the vocabulary returned for this league (for example Scheduled, In Progress, Final, or the soccer status). With upcoming=true, an explicit value replaces the baseball default status set.

cursorstringlimitinteger

List games / matches in a leaguecURL

200Example

Reference context: WKBL.

Overview · Response conventions

List games / matches in a league

curl --request GET \
  --url 'https://api.sportquanta.com/v1/wkbl/games' \
  --header 'Authorization: Bearer <token>'

200 · Example

{
  "data": {
    "items": [
      {
        "id": "<string>",
        "canonical_id": "<string>",
        "external_ids": {
          "SOURCE_KEY": "SOURCE_ENTITY_ID"
        },
        "created_at": "2026-10-29T00:00:00Z",
        "updated_at": "2026-10-29T00:00:00Z",
        "season": "<string>",
        "status": "<string>",
        "home_team_id": "<string>",
        "away_team_id": "<string>",
        "game_type": "<string>",
        "cup_stage": "group",
        "cup_group": "<string>",
        "schedule_date": "<string>",
        "scheduled_start_utc": "<string>",
        "venue_id": "<string>",
        "attendance": 0,
        "duration_minutes": 0,
        "linescore": {
          "home_score": 0,
          "away_score": 0,
          "period": 0,
          "game_clock": "<string>",
          "periods": [
            {
              "period": 0,
              "home_score": 0,
              "away_score": 0
            }
          ]
        },
        "home_scoring_breakdown": {
          "points_in_paint": {
            "value": 0,
            "availability": "<string>",
            "calculation_mode": "<string>",
            "source": "<string>"
          },
          "fast_break_points": {
            "value": 0,
            "availability": "<string>",
            "calculation_mode": "<string>",
            "source": "<string>"
          },
          "second_chance_points": {
            "value": 0,
            "availability": "<string>",
            "calculation_mode": "<string>",
            "source": "<string>"
          },
          "bench_points": {
            "value": 0,
            "availability": "<string>",
            "calculation_mode": "<string>",
            "source": "<string>"
          }
        },
        "away_scoring_breakdown": {
          "points_in_paint": {
            "value": 0,
            "availability": "<string>",
            "calculation_mode": "<string>",
            "source": "<string>"
          },
          "fast_break_points": {
            "value": 0,
            "availability": "<string>",
            "calculation_mode": "<string>",
            "source": "<string>"
          },
          "second_chance_points": {
            "value": 0,
            "availability": "<string>",
            "calculation_mode": "<string>",
            "source": "<string>"
          },
          "bench_points": {
            "value": 0,
            "availability": "<string>",
            "calculation_mode": "<string>",
            "source": "<string>"
          }
        },
        "live": {
          "status_code": "<string>",
          "status_label": "<string>",
          "period_label": "<string>",
          "period_ordinal": 0,
          "score": {
            "home": 0,
            "away": 0
          },
          "clock": {
            "minute": 0,
            "second": 0,
            "display": "<string>",
            "is_running": true
          },
          "state_revision": 0,
          "updated_at": "2026-10-29T00:00:00Z"
        }
      }
    ],
    "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

leagueenum<string>default:wkblrequired

League for this reference section: wkbl.

Available options: wkbl

Query Parameters

datestring<date>

Exact schedule date. Overrides date_from / date_to.

date_fromstring<date>

Inclusive schedule-date bound (YYYY-MM-DD), supported across sports. Ignored when date is supplied.

date_tostring<date>

Inclusive schedule-date bound (YYYY-MM-DD), supported across sports. Ignored when date is supplied.

seasonstring

League-specific stored season. Soccer uses an exact string match. Basketball accepts a start year or supported cross-year label; baseball/NFL/NHL parse a year.

weekinteger

NFL-only week filter; ignored by other leagues.

game_typeenum<string>

NHL-only season-phase filter; ignored by other leagues.

Available options: preseason, regular, postseason, all-star, other

team_idstring

statusstring

Exact, case-sensitive stored status. Use the vocabulary returned for this league (for example Scheduled, In Progress, Final, or the soccer status). With upcoming=true, an explicit value replaces the baseball default status set.

upcomingboolean

Baseball-only duplicate-safe upcoming list. Defaults to league-local today through +30 days and excludes postponed/cancelled/final rows unless status is supplied.

cursorstring

limitintegerdefault:25

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

provenancebooleandefault:false

Opt in to per-field provenance on supported single game, match, team, player, and venue reads. Lists and composites accept the flag but generally omit provenance. It is returned under _meta.provenance only when source metadata exists.

Response

200401403404429500502503application/json

Page of games / matches.

dataobjectrequired

data.itemsobject[] | nullrequired

data.items.idstring

data.items.canonical_idstring

data.items.external_idsobject

Map from the exact stored source/namespace key to that provider's identifier for this entity. Keys vary by entity and league. Values are strings, even when the provider ID looks numeric. Use the exact key and value for external-ID lookups; these are distinct from the canonical ID. SOURCE_KEY below is an illustrative placeholder.

data.items.external_ids.{key}string

data.items.created_atstring<date-time>

Canonical document creation timestamp, when present; not the scheduled start or event time.

data.items.updated_atstring<date-time>

Canonical document update timestamp, when present. It is not a guarantee that every field was refreshed at this time; field provenance carries individual ingestion times.

data.items.seasonstring

data.items.statusstring

data.items.home_team_idstring

data.items.away_team_idstring

data.items.game_typestring

data.items.cup_stageenum<string>

NBA only. The NBA Cup round, from the note ESPN's scoreboard puts on every cup game (espn:cup-calendar); the final is also known from its own game type (in-season-tournament). Omitted for a game outside the cup. Group and knockout games are regular-season games, so their game_type stays regular.

Available options: group, quarterfinal, semifinal, final

data.items.cup_groupstring

NBA only. The NBA Cup group as the NBA's season schedule writes it (e.g. East Group A); omitted for knockout and non-cup games, and when the schedule names no group.

data.items.schedule_datestring

data.items.scheduled_start_utcstring

data.items.venue_idstring

data.items.attendanceinteger

data.items.duration_minutesinteger

data.items.linescoreobject

data.items.linescore.home_scoreinteger

data.items.linescore.away_scoreinteger

data.items.linescore.periodinteger

data.items.linescore.game_clockstring

data.items.linescore.periodsobject[]

data.items.linescore.periods.periodintegerrequired

data.items.linescore.periods.home_scoreinteger

data.items.linescore.periods.away_scoreinteger

data.items.home_scoring_breakdownobject

data.items.home_scoring_breakdown.points_in_paintobjectrequired

data.items.home_scoring_breakdown.points_in_paint.valueinteger | nullrequired

data.items.home_scoring_breakdown.points_in_paint.availabilitystringrequired

data.items.home_scoring_breakdown.points_in_paint.calculation_modestring | nullrequired

data.items.home_scoring_breakdown.points_in_paint.sourcestring | nullrequired

data.items.home_scoring_breakdown.fast_break_pointsobjectrequired

data.items.home_scoring_breakdown.fast_break_points.valueinteger | nullrequired

data.items.home_scoring_breakdown.fast_break_points.availabilitystringrequired

data.items.home_scoring_breakdown.fast_break_points.calculation_modestring | nullrequired

data.items.home_scoring_breakdown.fast_break_points.sourcestring | nullrequired

data.items.home_scoring_breakdown.second_chance_pointsobjectrequired

data.items.home_scoring_breakdown.second_chance_points.valueinteger | nullrequired

data.items.home_scoring_breakdown.second_chance_points.availabilitystringrequired

data.items.home_scoring_breakdown.second_chance_points.calculation_modestring | nullrequired

data.items.home_scoring_breakdown.second_chance_points.sourcestring | nullrequired

data.items.home_scoring_breakdown.bench_pointsobjectrequired

data.items.home_scoring_breakdown.bench_points.valueinteger | nullrequired

data.items.home_scoring_breakdown.bench_points.availabilitystringrequired

data.items.home_scoring_breakdown.bench_points.calculation_modestring | nullrequired

data.items.home_scoring_breakdown.bench_points.sourcestring | nullrequired

data.items.away_scoring_breakdownobject

data.items.away_scoring_breakdown.points_in_paintobjectrequired

data.items.away_scoring_breakdown.points_in_paint.valueinteger | nullrequired

data.items.away_scoring_breakdown.points_in_paint.availabilitystringrequired

data.items.away_scoring_breakdown.points_in_paint.calculation_modestring | nullrequired

data.items.away_scoring_breakdown.points_in_paint.sourcestring | nullrequired

data.items.away_scoring_breakdown.fast_break_pointsobjectrequired

data.items.away_scoring_breakdown.fast_break_points.valueinteger | nullrequired

data.items.away_scoring_breakdown.fast_break_points.availabilitystringrequired

data.items.away_scoring_breakdown.fast_break_points.calculation_modestring | nullrequired

data.items.away_scoring_breakdown.fast_break_points.sourcestring | nullrequired

data.items.away_scoring_breakdown.second_chance_pointsobjectrequired

data.items.away_scoring_breakdown.second_chance_points.valueinteger | nullrequired

data.items.away_scoring_breakdown.second_chance_points.availabilitystringrequired

data.items.away_scoring_breakdown.second_chance_points.calculation_modestring | nullrequired

data.items.away_scoring_breakdown.second_chance_points.sourcestring | nullrequired

data.items.away_scoring_breakdown.bench_pointsobjectrequired

data.items.away_scoring_breakdown.bench_points.valueinteger | nullrequired

data.items.away_scoring_breakdown.bench_points.availabilitystringrequired

data.items.away_scoring_breakdown.bench_points.calculation_modestring | nullrequired

data.items.away_scoring_breakdown.bench_points.sourcestring | nullrequired

data.items.liveobject

data.items.live.status_codestringrequired

data.items.live.status_labelstringrequired

data.items.live.period_labelstring

data.items.live.period_ordinalintegerrequired

data.items.live.scoreobject

data.items.live.score.homeintegerrequired

data.items.live.score.awayintegerrequired

data.items.live.clockobject

data.items.live.clock.minuteinteger

data.items.live.clock.secondinteger

data.items.live.clock.displaystring

data.items.live.clock.is_runningbooleanrequired

data.items.live.state_revisioninteger

data.items.live.updated_atstring<date-time>required

data.next_cursorstring

Opaque continuation cursor; omitted on the last page.

_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.