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

Read both rosters

Use GET /x/sports/{league}/games/{id}/roster for the players of both teams. Find the game ID with List football games.
  • rosters holds each team’s teamId & its playerIds, in X’s order.
  • players holds each player once, keyed by ID, with jersey, position, headshot & X account.
  • A player’s xUser also says whether the account is protected. It also says whether the account can offer subscriptions & has a highlighted label.
Rosters carry no college, birth details or large photos, so those fields are null. The box score has them for players who recorded stats.

Path parameters

Query parameters

Headers

Response

200 OK

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

400 Unsupported league

{ "error": "unsupported_league", "message": "Rosters & player props cover nfl only. Send nfl as the league." } Send nfl as the league. A game ID that is not a number gets invalid_game_id. 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 NFL game with this ID. 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." }