Using the REST API for Integrations

By System Admin

REST API Overview

Tender Access Hub provides a RESTful API that allows you to integrate tender data into your own applications, dashboards, or workflows.

Getting an API Key

Navigate to Dashboard ??? API Keys
Click Generate New Key
Give your key a descriptive name (e.g., "CRM Integration")
Copy the generated key immediately ??? it will only be shown once

You can create multiple API keys for different applications. Keys can be revoked at any time from the same page.

Authentication

Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Available Endpoints

Method	Endpoint	Description
GET	/api/v1/tenders	List tenders with pagination and filters
GET	/api/v1/tenders/{id}	Get full tender details
GET	/api/v1/categories	List all tender categories
GET	/api/v1/countries	List all countries with tender counts

Query Parameters

q ??? Search keyword
country ??? Filter by country code
category ??? Filter by category slug
page ??? Page number (default: 1)
per_page ??? Results per page (default: 20, max: 100)

Rate Limiting

API requests are rate-limited to protect system performance. Current limits are displayed in the response headers. Exceeding the limit returns a 429 Too Many Requests response.

Example Request

curl -H "Authorization: Bearer YOUR_KEY" 
  "https://yourdomain.com/api/v1/tenders?country=KE&category=construction&page=1"