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

Read a football game’s live score

Use GET /x/sports/{league}/games/{id} for 1 game’s score, clock & situation. Find the game ID with List football games. Call it again to follow a live game.
  • home & away hold each team’s teamId, points & timeoutsLeft.
  • periods lists the points of each period, in order.
  • situation has the down, the yards to go & the team with the ball.
  • lastPlay is the latest play, with the fields Get football plays returns.
  • teams & players hold each team & player once, keyed by ID.
situation & lastPlay are null before kickoff. Fields such as teamId & playerId are keys of teams & players.

Path parameters

Query parameters

Headers

Response

200 OK

Each value in teams has these fields.Each value in players has these fields.

400 Invalid game ID

{ "error": "invalid_game_id", "message": "Send a numeric game ID, such as 2055084502741811200." } The game ID is not a number. A league other than nfl or ncaafb gets invalid_league. Both answers are free.

404 Game not found

{ "error": "game_not_found", "message": "Game not found. Find game IDs with GET /x/sports/nfl/games." } X knows no game with this ID in the league. This answer is free.

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.

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." }
  • 404 { "error": "not_found", "message": "Resource not found." }
  • 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." }