Skip to main content

​
Directory API

Access 60,000+ verified business and government entity listings across South Africa.

​
Search Directory

GET /api/v1/directory

​
Query Parameters

ParameterTypeDescription
qstringSearch query (name, category)
ward_codestringFilter by ward
categorystringFilter by category slug
typestringbusiness or government
limitnumberResults per page (default: 20)

​
Example Request

curl -H "x-api-key: your_key" \
  "https://visita.co.za/api/v1/directory?q=clinic&ward_code=79700026"

​
Example Response

{
  "success": true,
  "data": [
    {
      "id": "abc-123",
      "name": "Addington Hospital",
      "category": "Healthcare",
      "subcategory": "Hospital",
      "type": "government",
      "address": "123 Marine Parade, Durban",
      "phone": "+27 31 123 4567",
      "ward_code": "79700026",
      "location": {
        "lat": -29.8587,
        "lng": 31.0218
      }
    }
  ],
  "meta": {
    "total": 15,
    "limit": 20
  }
}

​
Get Entity Details

GET /api/v1/directory/:slug
Returns full entity information including:
  • Contact details
  • Operating hours
  • Categories
  • Photos (if available)
  • Reviews summary