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

# Match Detail

> Full match data — teams, scores, venue, referee, lineups, and 3D animation widget

## Get Match Detail

Returns the **complete** match payload including team & competition names, venue, referee, scores by period, and an embedded 3D animation widget URL.

```text theme={null}
GET /api/v1/match/{matchId}?tz=00:00
```

<CodeGroup>
  ```bash New canonical theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/match/ezk96i3gzz5a1kn"
  ```

  ```bash Classic theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/match/ezk96i3gzz5a1kn"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "success": true,
  "cacheHit": false,
  "match": {
    "id": "ezk96i3gzz5a1kn",
    "sportId": 1,
    "matchStatus": 3,
    "matchTime": 1782612000,
    "homeScores": [1, 0, 0, 3, 2, 0, 0],
    "awayScores": [3, 2, 0, 0, 6, 0, 0],
    "homeTeam": {
      "id": "zjek33i08didko2",
      "name": "Jordan",
      "logo": "92a6308394834fd38eadaf9105c99749.png",
      "sportId": 1,
      "national": 1
    },
    "awayTeam": {
      "id": "8vmqy9i232b4k9r",
      "name": "Argentina",
      "logo": "ef7329946e1741b9ade4fedbf739158a.png",
      "national": 1
    },
    "competition": {
      "id": "p0ndkz6izigq3z1",
      "name": "FIFA World Cup",
      "logo": "da617cd58cd9cffaae0daec865457fb5.png"
    },
    "venue": {
      "name": "Dallas Stadium",
      "capacity": 92967,
      "city": "Dallas",
      "country": "United States"
    },
    "referee": null
  },
  "incidents": [],
  "stats": [],
  "lineups": null,
  "tables": [],
  "animation": {
    "url": "https://widgets.sportsapipro.com/3d/football?match=ezk96i3gzz5a1kn",
    "ratio": 0.505
  },
  "stream": null,
  "esportsStats": null
}
```

| Field                             | Type           | Description                                                              |
| --------------------------------- | -------------- | ------------------------------------------------------------------------ |
| `match`                           | object         | Core match data                                                          |
| `match.homeTeam`                  | object         | Home team `{ id, name, logo, national }` (`national: 1` = national team) |
| `match.awayTeam`                  | object         | Away team                                                                |
| `match.competition`               | object         | Competition `{ id, name, logo }`                                         |
| `match.venue`                     | object         | Stadium `{ name, city, capacity, country }`                              |
| `match.matchTime`                 | number         | Unix epoch (seconds)                                                     |
| `match.matchStatus`               | number         | 1 NS · 2 Live · 3 FT · 4 Postponed · 5 Cancelled                         |
| `match.homeScores` / `awayScores` | array          | `[FT, 1H, 2H, ET1, ET2, Pens, …]`                                        |
| `incidents`                       | array          | See [Match Incidents](/api-reference/v6-aiscore/match-incidents)         |
| `stats`                           | array          | See [Match Stats](/api-reference/v6-aiscore/match-stats)                 |
| `lineups`                         | object \| null | See [Match Stats](/api-reference/v6-aiscore/match-stats)                 |
| `animation`                       | object \| null | 3D animation widget `{ url, ratio }`                                     |
| `esportsStats`                    | object \| null | Esports-only payload                                                     |

**Cache TTL:** 60 s.

<Tip>
  The match-detail call is the single best way to hydrate a list returned by `/today` or `/future`. Use the returned `match.id` as the lookup key.
</Tip>