Sports

List football games

Changed on

Lists NFL or college football games in a time window, with teams & scores. Use it to find game IDs & team IDs. Without from or to, X picks about 5 weeks around today. Each request costs 1 credit.

get/x/sports/{league}/games

Request

  • Base URL: https://xquik.com/api/v1
  • URL: https://xquik.com/api/v1/x/sports/{league}/games
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer
    • none

Path parameters

league'nfl' | 'ncaafb' required
Example:nfl

nfl for the NFL or ncaafb for college football, in any case. Another value gets a free 400 invalid_league before X is read.

Query parameters

fromstring

Start of the window. Takes an ISO 8601 date or time, such as 2026-10-01, or Unix seconds. A time without a zone reads as UTC. Defaults to 7 days before to. Alias sinceTime.

tostring

End of the window. Takes the forms of from. Defaults to 7 days after from. Alias untilTime.

teamstring

Keeps only 1 team's games, by team ID. Each game lists its teamIds. Aliases teamId & team_id.

fieldsstring
Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring
Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

The league's games in the window, earliest first

league'nfl' | 'ncaafb' required

The league whose games this list holds.

teamsobject required

The teams the games name, by team ID.

Example response

{
  "league": "nfl",
  "games": [
    {
      "id": "2055084502741811200",
      "seasonType": "RegularSeason",
      "week": 6,
      "startsAt": "2026-10-20T00:15:00.000Z",
      "status": "Closed",
      "clock": "00:00:00",
      "quarter": 4,
      "home": {
        "teamId": "689566294702555136",
        "points": 23
      },
      "away": {
        "teamId": "689566304366292992",
        "points": 17
      },
      "teamIds": [
        "689566294702555136",
        "689566304366292992"
      ],
      "periods": [
        {
          "type": "Quarter"
        }
      ],
      "odds": null
    }
  ],
  "teams": {}
}

Changes

  • e29bc136a9ccRevision changes
    • breaking

      the response property const value changed from /dashboard/account to /dashboard/billing for the status

    • breaking

      the response property const value changed from /dashboard/account to /dashboard/billing for the status

    • breaking

      the response property const value changed from /dashboard/account to /dashboard/billing for the status

    • breaking

      the response property const value changed from Ask the user to top up at /dashboard/account. This key cannot open checkout. to Ask the user to top up at /dashboard/billing. This key cannot open checkout. for the status

  • d94eba2599ffRevision changes
    • info

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