# South Africa eTenders Procurement API

> South African government tenders and awards from the National Treasury eTenders portal (OCDS)

- Vendor: `southafricaetendersprocurement` · version 1.0 · category Government Data · tags south africa tenders api, government procurement api, ocds api, public tenders api, etenders api, contract awards api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/southafricaetendersprocurement
- This document: https://apiclay.com/docs/southafricaetendersprocurement.md
- OpenAPI 3.1: https://apiclay.com/api/southafricaetendersprocurement/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `southafricaetendersprocurement`
- Updated: 2026-11-18

## About

## South Africa eTenders Procurement API

Public procurement releases from South Africa's National Treasury eTenders portal in the Open Contracting Data Standard (OCDS): tenders published by national, provincial and municipal buyers with title, description, category, value, closing date, documents and briefing details, and awards, for a date range.

Data comes from **etenders.gov.za** (https://www.etenders.gov.za). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/releases?dateFrom=2026-11-01&amp;dateTo=2026-11-10&amp;PageNumber=1&amp;PageSize=50`.

### Routes

#### GET `/releases` - Procurement releases
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| dateFrom | query | string | yes | Start date `YYYY-MM-DD`. |
| dateTo | query | string | yes | End date `YYYY-MM-DD`. |
| PageNumber | query | number | no | Page, from 1. |
| PageSize | query | number | no | Releases per page. |

Returns: OCDS release package: `publisher`, `license`, `releases[]` with `ocid`, `date`, `tag`, `buyer`, `tender` (`title`, `description`, `mainProcurementCategory`, `value`, `tenderPeriod`, `documents`, `briefingSession`), `awards[]`, `links.next`.

### Caveats

- Data is published by National Treasury under its open data licence (see `license` in each response).
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by etenders.gov.za.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /releases — Procurement releases
- Gateway: `GET https://api.apiclay.com/v1/api/southafricaetendersprocurement/releases`
- Public query params: `dateFrom` (string, required), `dateTo` (string, required), `PageNumber` (number), `PageSize` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/southafricaetendersprocurement/releases?dateFrom=<dateFrom>&dateTo=<dateTo>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
