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

Read team totals & player stats

Use GET /x/sports/{league}/games/{id}/box-score for a game’s stats. Find the game ID with List football games.
  • home & away hold each team’s totals & a players list.
  • totals has first downs, third downs, passing, rushing, penalties, turnovers & time of possession.
  • Each players entry has a playerId & the stat groups X sent for that player.
  • The top-level players holds each player once, keyed by ID, with name, position & photos.
Stat groups X did not send are absent, so a kicker has no passing. A game that has not started has no stats yet, so totals is null.

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." }