API Changelog
Track changes, new features, and improvements to the Tenders-SA API.
v2.0.0
Feature- •Full v2 API rewrite — dedicated Cloudflare Worker at api.tenders-sa.org with isolated D1 database
- •80+ endpoints across 17 resource groups: tenders (27), awards (12), organizations, companies, directors, categories, provinces, SEO, industry, services, OCDS, intelligence, forensic, CIPC, newsletters, documents, meta
- •Cursor-based pagination replacing page-based — stable under concurrent writes
- •All paths moved to /v2/ prefix. /v1/ paths are deprecated and no longer served
- •New resource groups: Directors, Provinces (with health scores), SEO & Content, Industry Benchmarks, Services, OCDS, Intelligence, Forensic/Restricted Suppliers, CIPC, Newsletters, Documents
- •Auto-generated OpenAPI 3.0 spec served live at /v2/openapi.json (no auth), interactive Redocly viewer at /v2/docs
- •Public no-auth endpoints: /v2/meta/status, /v2/meta/provinces, /v2/meta/categories
- •API usage logging, per-key daily/monthly rate limits, response caching at edge (5min–6hr TTLs)
- •5-minute sync cycle from main app via cursor-based delta export endpoints
SDK v0.1 (Legacy)
Feature- •Released official SDK packages — TypeScript (@tenders-sa-org/sdk-js), Python (tendersa-sdk), and CLI (@tenders-sa-org/cli)
- •GitHub repos: https://github.com/Tenders-SA/js, https://github.com/Tenders-SA/python, https://github.com/Tenders-SA/cli
- •Live OpenAPI 3.0 specification at https://api.tenders-sa.org/v2/openapi.json
v1.2.0 (Legacy)
Feature- •Added tenders/{id}/analysis endpoint for AI-powered document analysis (v1)
- •Added companies/search and companies/{name} endpoints with B-BBEE and CIDB data (v1)
- •Added organizations/{id} and organizations/{id}/tenders endpoints (v1)
- •Added meta/status and meta/provinces endpoints (v1)
- •Added fields parameter for sparse response support (v1)
v1.1.0 (Legacy)
Feature- •Added awards/analytics endpoint with groupBy support (v1)
- •Added aiSummary, aiConfidence, and classificationConfidence fields to tender responses (v1)
- •Added estimatedValue object with min/max/median/confidence/methodology to tender responses (v1)
v1.0.0 (Legacy)
Feature- •Initial public release of the Tenders-SA API (v1 — now deprecated)
- •19 endpoints across tenders, awards, companies, organizations, analysis, and meta
- •API key-based authentication with Professional and Enterprise plans
- •Rate limiting: 500 req/day (Professional), 10,000 req/day (Enterprise)