Discovery
The unauthenticated endpoints an agent uses to learn the API, read pricing, check status, and verify a Pass — no key required.
Discovery endpoints let an agent find its footing before it holds a key. They describe the API, publish pricing and the task catalogue, report status, and verify a Pass. None of them need an API key — they're safe to call cold.
/v1/openapi.jsonThe machine-readable OpenAPI 3.1 contract for the whole surface.
The full request and response shapes, in a format your tooling can generate a client from.
curl https://api.hannu.africa/v1/openapi.json \
-H "Authorization: Bearer $HANNU_KEY"/llms.txtA compact, model-readable index of the docs and the API.
Point a model here to orient it. It's plain text, kept small on purpose.
/v1/contentStructured docs and reference content for programmatic reads.
/v1/pricingCurrent pricing and the task-type catalogue.
Pricing is served here rather than written into the docs, so the numbers you read are the live ones. Read amounts as integer minor units.
curl https://api.hannu.africa/v1/pricing \
-H "Authorization: Bearer $HANNU_KEY"/v1/statusPlatform status and availability.
/v1/pass/verifyVerify a hannu Pass presented at a visit.
Public and keyless so a verifier at the door can check a Pass without holding platform credentials. See Pass.
Every endpoint on this page is unauthenticated — don't send an Authorization header. Everything else in the reference requires a bearer key; see Authentication.