Developers

API documentation

A REST and HL7 FHIR R4 interface over the Veligraph register: 255,963 facility records across 53 African countries in one schema.

The API is in early access. Request a key and we respond within one business day. Evaluation keys are free.

Authentication

Send your key on every request as X-API-Key. Keys are scoped per organisation.

Endpoints

Endpoint	Returns
`GET /v1/facilities/{id}`	One facility by Veligraph ID
`GET /v1/facilities?country=ng&state=lagos&level=secondary`	Filtered facility list, paginated
`GET /v1/countries`	Coverage and counts per country
`GET /v1/changes?since=2026-08-01`	Change feed (licensing tier)
`GET /fhir/Location/{id}` · `GET /fhir/Organization/{id}`	FHIR R4 resources

Facility IDs

Every record has a stable ID such as AF-NG-24-16-1-2-1-0026: continent, country, then the facility's position in the national register hierarchy. IDs survive re-ingests, so they are safe to store.

Example response

{
  "id": "AF-NG-24-16-1-2-1-0026",
  "name": "Lagos University Teaching Hospital",
  "country": "NG", "state": "Lagos", "lga": "Mushin",
  "level": "Secondary", "ownership": "Public",
  "beds": 1500,
  "staffing": { "doctors": 800, "nurses": 150 },
  "services": { "laboratory": true, "imaging": true, "pharmacy": true },
  "status": "Functional",
  "location": { "lat": 6.517373, "lng": 3.353626 },
  "source": { "name": "NHFR", "vintage": "2026" }
}

Quotas

Evaluation keys carry a per-day quota suited to testing. Production quotas are set by agreement; see getting access.

Prefer a file? Download the free sample extract. Building on MCP? The register is also exposed as an MCP server for AI agents; ask for the endpoint.