> ## 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.

# Tenders API

> Access government procurement data

# Tenders API

Access active and historical government tenders from South African municipalities.

## List Tenders

```http theme={null}
GET /api/v1/tenders
```

### Query Parameters

| Parameter   | Type   | Description                              |
| ----------- | ------ | ---------------------------------------- |
| `status`    | string | `active`, `closed`, `awarded`            |
| `province`  | string | Filter by province code                  |
| `category`  | string | Tender category (construction, IT, etc.) |
| `min_value` | number | Minimum tender value (ZAR)               |
| `max_value` | number | Maximum tender value (ZAR)               |
| `limit`     | number | Results per page (default: 20)           |

### Example Request

```bash theme={null}
curl -H "x-api-key: your_key" \
  "https://visita.co.za/api/v1/tenders?status=active&province=GP"
```

### Example Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "tender-456",
      "title": "Road Rehabilitation Project",
      "reference_number": "MUNI/2026/001",
      "institution": "City of Johannesburg",
      "province": "GP",
      "status": "active",
      "estimated_value": 2500000,
      "closing_date": "2026-02-15",
      "categories": ["Construction", "Roads"],
      "description": "Rehabilitation of 5km road in Ward 45..."
    }
  ],
  "meta": {
    "total": 1700,
    "limit": 20
  }
}
```

## Get Tender Details (Visita Pro)

```http theme={null}
GET /api/v1/tenders/:id
```

Returns exhaustive tender intelligence, including everything in the list view plus:

* **AI Risk Analysis**: Scoring for corruption risk, "set-aside" patterns, and bid viability.
* **Connection Mapping**: Automated detection of ties between the issuing entity, government officials, and known business directors.
* **Full Description & Requirements**: Contact persons and submission criteria.

<Info>
  Full tender intelligence requires an API key with `read:tenders:pro` permissions, included in the **Visita Pro** and **Enterprise** tiers.
</Info>

<Info>
  Tender data is updated daily from eTenders Portal
</Info>