Skip to main content

​
Wards API

Get information about South African wards including boundaries, demographics, and statistics.

​
List Wards

GET /api/v1/wards

​
Query Parameters

ParameterTypeDescription
provincestringFilter by province code (e.g., GP, WC)
municipalitystringFilter by municipality code
limitnumberResults per page (default: 20, max: 100)
offsetnumberSkip N results

​
Example Request

curl -H "x-api-key: your_key" \
  "https://visita.co.za/api/v1/wards?province=GP&limit=10"

​
Example Response

{
  "success": true,
  "data": [
    {
      "ward_code": "79700026",
      "ward_number": 26,
      "municipality_code": "ETH",
      "municipality_name": "eThekwini Metropolitan",
      "province": "KZN",
      "population": 12500,
      "councillor_name": "M. Nzimande",
      "councillor_party": "ANC"
    }
  ],
  "meta": {
    "total": 4468,
    "limit": 10,
    "offset": 0
  }
}

​
Get Single Ward

GET /api/v1/wards/:ward_code

​
Example

curl -H "x-api-key: your_key" \
  "https://visita.co.za/api/v1/wards/79700026"

​
Response

Returns detailed ward information including:
  • Demographics (population, households)
  • Current councillor
  • Municipality details
  • Weather summary
  • Recent activity counts