# Fixtures & Scores API
> Recent match results with scores, upcoming fixtures and all events on a given date — across football (soccer) and other sports. Look up by league or by date for schedules, final scores, venues and rounds.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/fixtures-api/..."
```

## Pricing
- **Free** (Free) — 2,500 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 45,000 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 220,000 calls/Mo, 18 req/s
- **Mega** ($89/Mo) — 900,000 calls/Mo, 45 req/s

## Endpoints

### Fixtures

#### `GET /v1/day` — Events on a date

**Parameters:**
- `date` (query, required, string) — Date YYYY-MM-DD Example: `2026-05-23`
- `sport` (query, optional, string) — Sport (default Soccer) Example: `Soccer`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fixtures-api/v1/day?date=2026-05-23&sport=Soccer"
```

**Response:**
```json
{
    "data": {
        "date": "2026-05-23",
        "count": 3,
        "sport": "Soccer",
        "events": [
            {
                "id": "2265406",
                "date": "2026-05-23",
                "time": "16:00:00",
                "event": "Bologna vs Inter Milan",
                "round": "38",
                "sport": "Soccer",
                "thumb": "https://r2.thesportsdb.com/images/media/event/thumb/1taz061755935175.jpg",
                "venue": "Stadio Renato Dall'Ara",
                "league": "Italian Serie A",
                "season": "2025-2026",
                "status": "FT",
                "away_team": "Inter Milan",
                "home_team": "Bologna",
                "timestamp": "2026-05-23T16:00:00",
                "away_score": 3,
                "home_score": 3
            },
            {
                "id": "2265409",
                "date": "2026-05-23",
                "time": "18:45:00",
                "event": "Lazio vs Pisa",
                "round": "38",
                "sport": "Soccer",
                "thumb": "https://r2.thesportsdb.com/images/media/event/thumb/wl2pec1755935186.jpg",
                "venue": "Stadio Olimpico",
                "league": "Italian Serie A",
                "season": "2025-2026",
                "status": "FT",
                "away_team": "Pisa",
                "home_team": "Lazio",
                "timestamp": "2026-05-23T18:45:00",
                "away_score": 1,
               
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/results` — Recent results (with scores)

**Parameters:**
- `league` (query, required, string) — TheSportsDB league id Example: `4328`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fixtures-api/v1/results?league=4328"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "events": [
            {
                "id": "2267452",
                "date": "2026-05-24",
                "time": "15:00:00",
                "event": "West Ham United vs Leeds United",
                "round": "38",
                "sport": "Soccer",
                "thumb": "https://r2.thesportsdb.com/images/media/event/thumb/iejgyx1750321086.jpg",
                "venue": "London Stadium",
                "league": "English Premier League",
                "season": "2025-2026",
                "status": "FT",
                "away_team": "Leeds United",
                "home_team": "West Ham United",
                "timestamp": "2026-05-24T15:00:00",
                "away_score": 0,
                "home_score": 3
            }
        ],
        "league_id": 4328
    },
    "meta": {
        "timestamp": "2026-05-30T01:26:04.052Z",
        "request_id": "4d610fea-2936-45bb-9e15-ad9e4b869cac"
    },
    "status": "ok",
    "message": "Results retrieved successfully",
    "success": true
}
```

#### `GET /v1/upcoming` — Upcoming fixtures

**Parameters:**
- `league` (query, required, string) — TheSportsDB league id Example: `4328`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fixtures-api/v1/upcoming?league=4328"
```

**Response:**
```json
{
    "data": {
        "count": 0,
        "events": [],
        "league_id": 4328
    },
    "meta": {
        "timestamp": "2026-05-30T01:26:04.372Z",
        "request_id": "b8847e68-2277-4ba8-b71a-d0be265233fa"
    },
    "status": "ok",
    "message": "Fixtures retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/fixtures-api
OpenAPI spec: https://www.oanor.com/api/fixtures-api/openapi.json