REST API Documentation

Programmatic access to the full Africa tender database. Enterprise plan only.

GET tenders Search tenders

Example request

https://botswanatenders.co.bw/demo4/api/v1/tenders.php?q=solar&country=KE&category=energy&page=1&per_page=50&api_key=YOUR_KEY

Returns paginated list of tenders. Params: q, country (2-letter ISO), category (slug), status, type, funding, region, closing_before, closing_after, page, per_page (max 100).

GET tender Single tender

Example request

https://botswanatenders.co.bw/demo4/api/v1/tenders.php?endpoint=tender&id=1234&api_key=YOUR_KEY

Returns full detail for one tender by ID including categories, metadata, and document URL.

GET countries All countries

Example request

https://botswanatenders.co.bw/demo4/api/v1/tenders.php?endpoint=countries&api_key=YOUR_KEY

Returns all 54 African countries with ISO codes, flags, regions, tender counts, and portal URLs.

GET categories All sectors

Example request

https://botswanatenders.co.bw/demo4/api/v1/tenders.php?endpoint=categories&api_key=YOUR_KEY

Returns all 18 procurement sectors with slugs, icons, and tender counts.

GET stats Live stats

Example request

https://botswanatenders.co.bw/demo4/api/v1/tenders.php?endpoint=stats&api_key=YOUR_KEY

Returns real-time counts: total tenders, open, added today, countries, awards.

GET awards Contract awards

Example request

https://botswanatenders.co.bw/demo4/api/v1/tenders.php?endpoint=awards&country=ZA&api_key=YOUR_KEY

Returns awarded contracts, filterable by country.

Response format

{"success":true,"meta":{"total":25176,"page":1,"per_page":50,"pages":504},"data":[{"id":1234,"title":"Solar street lighting...","country_code":"KE","closing_date":"2025-06-28","status":"closing_soon",...}]}