> ## 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.

# AI Predictions

> AI-powered predictions for upcoming matches across every sport

## Get Predictions

```text theme={null}
GET /api/v1/{sport}/predictions
```

Returns model-driven predictions for the next batch of upcoming matches (typically 50+).

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

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

### Response

```json theme={null}
{
  "success": true,
  "count": 54,
  "matches": [
    {
      "id": "9gklzi1e9g8im7x",
      "sportId": 1,
      "homeTeam": { "id": "4ndqmlilnzbgkve" },
      "awayTeam": { "id": "yzrkn6iyx4tnqle" },
      "matchTime": 1782604800
    }
  ],
  "teams": [
    { "id": "4ndqmlilnzbgkve", "name": "Univ Catolica", "logo": "..." }
  ]
}
```

**Cache TTL:** 30 s.

<Warning>
  Predictions are for informational purposes only. Combine with [`/match/{id}/odds`](/api-reference/v6-aiscore/match-odds) for bookmaker context.
</Warning>
