> ## Documentation Index
> Fetch the complete documentation index at: https://www.thestatsapi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /football/matches/{match_id}/odds/players

> Return player-prop odds for a match, grouped by market and bookmaker.

Return player-prop odds for a match from a bookmaker.

## Endpoint

```text theme={null}
GET https://api.thestatsapi.com/api/football/matches/{match_id}/odds/players
```

Markets are grouped by key. Ladder markets such as `player_shots`, `player_shots_on_target`, and `player_assists` emit one row per player, line, and market type. Flat markets such as `anytime_goalscorer` emit one entry per player. `first_goalscorer` has no line or direction, so `line` and `market_type` are `null`.

## Path parameters

| Name       | Type   | Required | Description                       |
| ---------- | ------ | -------- | --------------------------------- |
| `match_id` | string | Yes      | Match ID. Example: `mt_404012971` |

## Query parameters

| Name        | Type   | Required | Default       | Description                                                                                                                                                      |
| ----------- | ------ | -------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `markets`   | string | No       | all available | Comma-separated player-prop market keys. Available values: `anytime_goalscorer`, `first_goalscorer`, `player_shots`, `player_shots_on_target`, `player_assists`. |
| `bookmaker` | string | No       | `bet365`      | Bookmaker key. Currently supported: `bet365`.                                                                                                                    |

## Response

```json theme={null}
{
  "data": {
    "match_id": "mt_404012971",
    "home_team": {
      "id": "tm_7355123",
      "name": "Comerciantes Unidos"
    },
    "away_team": {
      "id": "tm_18159",
      "name": "Sport Boys"
    },
    "kickoff_at": "2026-05-25T20:30:00.000Z",
    "bookmaker": "bet365",
    "markets": [
      {
        "name": "anytime_goalscorer",
        "players": [
          {
            "id": "pl_29627593",
            "name": "Mohamed Salah",
            "line": 0.5,
            "market_type": "Over",
            "odd": 1.85
          }
        ]
      }
    ]
  }
}
```

<Note>
  Bet365 prices Over almost exclusively on player props today. Under prices will appear when a bookmaker that quotes them is added.
</Note>