African Healthcare Facilities API

Healthcare facility locations, services, and capacity data across African countries. Find hospitals, clinics, health centers, pharmacies, and laboratories with proximity search powered by WHO AFRO and national health departments.

Live

Base URL

https://api.crimate.net/v1/healthcare

Authentication

Include your Healthcare API key in the Authorization header.

curl -H "Authorization: Bearer db_healthcare_live_YOUR_KEY" \
     https://api.crimate.net/v1/healthcare/stats

Endpoints

GET/v1/healthcare/facilities

List healthcare facilities with optional country, region, type, and service filters

Parameters: country, region, facility_type, service, page, per_page

Example

GET /v1/healthcare/facilities?country=ZA&facility_type=hospital

GET/v1/healthcare/facilities/{facilityCode}

Get facility details including services and capacity

Parameters: facilityCode (path)

Example

GET /v1/healthcare/facilities/ZA-GAU-CHB-001

GET/v1/healthcare/facilities/search

Search facilities by name

Parameters: q (required)

Example

GET /v1/healthcare/facilities/search?q=Chris+Hani

GET/v1/healthcare/facilities/nearby

Find facilities within a radius of given coordinates

Parameters: lat (required), lng (required), radius_km (required, max 500)

Example

GET /v1/healthcare/facilities/nearby?lat=-26.2&lng=28.04&radius_km=10

GET/v1/healthcare/services

List available healthcare services and categories

Parameters: category (optional)

Example

GET /v1/healthcare/services

GET/v1/healthcare/countries

List countries with healthcare facility data and counts

Parameters: None

Example

GET /v1/healthcare/countries

GET/v1/healthcare/stats

Dataset statistics (total facilities, countries, services)

Parameters: None

Example

GET /v1/healthcare/stats

Response Examples

Nearby facilities response:

{
  "facilities": [
    {
      "facility_code": "ZA-GAU-CHB-001",
      "name": "Chris Hani Baragwanath Hospital",
      "facility_type": "hospital",
      "ownership": "public",
      "country_id": "ZA",
      "region": "Gauteng",
      "district": "Johannesburg",
      "latitude": -26.2612,
      "longitude": 27.9416,
      "distance_km": 3.2,
      "services": ["emergency", "surgery", "maternity", "pediatrics", "icu"],
      "capacity": {
        "bed_count": 3200,
        "icu_beds": 120,
        "staff_doctors": 800,
        "staff_nurses": 4500
      }
    }
  ]
}

Try It

Enter your Healthcare API key to make a live request. Generate a key in the dashboard.

Try It

Make a live API call from your browser

API Key

Endpoint

GET

curl -H "Authorization: Bearer db_healthcare_live_YOUR_KEY" \
     "https://crimate.net/v1/healthcare/stats"

Data Sources

WHO AFRO

World Health Organization Africa Regional Office. Facility data from the African Health Observatory covering hospitals and primary healthcare facilities.

National Master Facility Lists

Official facility registries from national health departments in South Africa, Kenya, Nigeria, Ghana, Tanzania, Uganda, Ethiopia, and Rwanda.

Rate Limits

Tier	Price	Rate Limit	Daily Quota	Monthly Quota
Free	R0/mo	10 req/min	100	1,000
Starter	R899/mo	60 req/min	5,000	50,000
Pro	R3,499/mo	300 req/min	Unlimited	500,000

Error Codes

All error responses follow a consistent JSON format:

{
  "error": "error_code",
  "message": "Human-readable description."
}

Status	Error Code	Description
400	invalid_request	The request body or query parameters are malformed.
401	unauthorized	Missing or invalid API key.
403	no_subscription	No active subscription for this API product.
403	quota_exceeded	Daily or monthly quota exceeded.
404	not_found	The requested resource does not exist.
429	rate_limit_exceeded	Too many requests. Check X-RateLimit-Remaining header.
500	internal_error	An unexpected server error occurred.