Skip to main content
GET https://xquik.com/api/v1/x/sports/{league}/games
1 credit per request · All plans from $0.00012/creditDirect MPP at USD 0.00015 per call · Supports guest paid reads

Find NFL & college football games

Use GET /x/sports/{league}/games to list a league’s games & find their IDs. Send nfl for the NFL or ncaafb for college football.
  • id is the game ID that the scoreboard, plays & box score routes take.
  • home & away name each team by teamId, with its points so far.
  • teams holds each team once, by team ID, with its name, colors & logos.
  • status tells games apart, such as Scheduled, InProgress or Closed.
Games come earliest first. Without from or to, X picks about 5 weeks around today. Send 1 of them & the window spans 7 days from it. To follow 1 team, send its ID in team. Copy the ID from teamIds of any game.

Path parameters

Query parameters

Choose fields

Headers

Response

200 OK

Each value in teams has these fields.

400 Invalid input

{ "error": "invalid_league", "message": "Send nfl or ncaafb as the league, such as /x/sports/nfl/games." } The league is not nfl or ncaafb. This answer is free. A from, to or team Xquik cannot read gets invalid_input. Its message says what to send.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

The read service returned an error. Retry after a short delay.
Next steps. Pass a game id to Get football scoreboard. The same id works with Get football plays and Get football box score.

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 402 { "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 424 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }
  • 502 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 503 { "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }