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

# Sports API

> Access community derbies and professional sports data

# Sports API

The Sports Intelligence API tracks community fixtures (soccer derbies, tournaments) and matches them with infrastructure records.

<Note>
  **Access Level Required**: Standard API access limits apply. Open to Free Tier developers building community-level tools.
</Note>

## Endpoints

### 1. Sports Events

Retrieve upcoming fixtures or historical match results.

`GET /api/v1/sports/events`

**Parameters**

* `ward_code` (optional string): Filter events taking place in a specific ward.
* `status` (optional string): e.g., `scheduled`, `live`, `completed`.

**Response**

```json theme={null}
{
  "data": [
    {
      "id": "uuid",
      "title": "Soweto Winter Derby",
      "sport_type": "soccer",
      "home_team": "Diepkloof United",
      "away_team": "Orlando Stars",
      "venue_name": "Diepkloof Zone 6 Fields",
      "event_date": "2026-06-15T14:00:00Z",
      "status": "scheduled"
    }
  ],
  "meta": {
    "count": 1
  }
}
```

### 2. Athletes

Retrieve information about community athletes and national professionals.

`GET /api/v1/sports/athletes`