Sports API

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

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

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

{
  "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