API Introduction
Base URL
Authentication
Rate Limits
Available Endpoints
Response Format
Error Handling

API Introduction

Build applications on top of Visita’s ward intelligence, directory, and tender data.

Base URL

https://visita.co.za/api/v1

Authentication

All API requests require an API key passed in the header:

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

Get your API key from your account settings at visita.co.za/account

Rate Limits

Tier	Requests/Month	Cost
Free	1,000	Free
Starter	10,000	R99/month
Pro	100,000	R499/month
Enterprise	Unlimited	Contact us

Available Endpoints

Wards

Get ward information, boundaries, and demographics

Directory

Search businesses and government entities

Tenders

Access active tenders and procurement data

Response Format

All endpoints return JSON:

{
  "success": true,
  "data": [...],
  "meta": {
    "total": 100,
    "page": 1,
    "limit": 20
  }
}

Error Handling

Code	Meaning
`401`	Invalid or missing API key
`403`	Tier limit exceeded
`429`	Rate limited
`500`	Server error