> For the complete documentation index, see [llms.txt](https://rock-odds.gitbook.io/rock-odds-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rock-odds.gitbook.io/rock-odds-docs/endpoints/single-game.md).

# Retrieve one game

Returns one game and its currently available markets.

```http
GET /games/{game_id}
```

## Path parameter

| Parameter | Type   | Description                                              |
| --------- | ------ | -------------------------------------------------------- |
| `game_id` | string | The game ID returned by a list response or stream event. |

Treat `game_id` as opaque. Do not construct an ID from team names, start time, or another provider's identifier.

## Example request

```bash
curl --get \
  --url "https://rockodds.live/api/v2/games/a1b2c3d4-e5f6-47a8-9012-3456789abcde" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "market=spread" \
  --data-urlencode "market=total"
```

## Query parameters

| Parameter | Type   | Required | Description                                                         |
| --------- | ------ | -------- | ------------------------------------------------------------------- |
| `market`  | string | No       | Include only this market type. Repeat it to include multiple types. |

## Example response

Unlike list endpoints, this endpoint returns the game object directly:

```json
{
  "game_id": "a1b2c3d4-e5f6-47a8-9012-3456789abcde",
  "sport": "NBA",
  "home_team": "Los Angeles Lakers",
  "away_team": "Boston Celtics",
  "start_time": "2026-08-28T19:30:00-04:00",
  "live": false,
  "markets": {}
}
```

Unlike the REST list endpoints, a single-game response can include locked lines. Check `locked` before treating any line as available.

## Not found

An unknown or unavailable ID returns `404 Not Found`:

```json
{
  "detail": "Game 'a1b2c3d4-e5f6-47a8-9012-3456789abcde' not found"
}
```

Remove locally stored games when the stream sends `game_remove`. A later lookup for the removed ID may return `404`.

## Rate limit

This endpoint allows up to 200 requests per minute per API key.
