---
title: Quickstart — your first request
description: From zero to live football data in five minutes.
---

# Quickstart: your first request

Five minutes from nothing to live football data. Everything here uses the
free tier.

## 1. Register and grab your token

Sign up at [/register/](/register/), click the email verification link, then
copy your API key from the [dashboard](/dashboard/).

## 2. Call the API

Today's matches:

```bash
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/events/?date_from=2026-08-02&date_to=2026-08-02"
```

```json
{
  "count": 74,
  "next": "https://sports.bzzoiro.com/api/v2/events/?date_from=2026-08-02&date_to=2026-08-02&limit=50&offset=50",
  "previous": null,
  "results": [
    {
      "id": 223510,
      "league_id": 85,
      "season_id": 1635,
      "home_team": "Aldosivi",
      "away_team": "Gimnasia y Esgrima",
      "event_date": "2026-08-02T17:30:00+00:00",
      "status": "upcoming",
      "home_score": null, "away_score": null,
      "live_websocket": true,
      "...": "..."
    }
  ]
}
```

## 3. Follow a match live

```bash
# All matches currently in play
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/events/live/"

# Everything about one match
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/events/223510/"
```

Each event exposes sub-resources — statistics, lineups, incidents,
head-to-head, odds, predictions:

```
/api/v2/events/{id}/stats/        shots, possession, xG, shotmap, momentum
/api/v2/events/{id}/lineups/      confirmed XI (or AI-predicted before kickoff)
/api/v2/events/{id}/incidents/    goals, cards, subs, VAR — chronological
/api/v2/events/{id}/h2h/          past meetings and win rates
/api/v2/events/{id}/odds/         consensus decimal odds
/api/v2/events/{id}/prediction/   model probabilities per market
```

## 4. Where to go next

- [Build a league page](/docs/guides/league-page/) — the full workflow from
  league id to standings, fixtures and top scorers.
- [Football API reference](/docs/football/) — every endpoint with inputs and
  outputs.
- [Connect to live WebSockets](/docs/guides/websockets/) — push updates
  instead of polling.
- [Working with images](/docs/guides/images/) — logos and player photos for
  your UI.

> **Note:** football is free. Tennis, CS2, darts, hockey, basketball and horse
> racing need the [Sports Addon](/addons/) ($5/mo) — same token, same
> conventions, different base path.