Authentication

The public API works with or without a key. A key is optional, but it raises your rate limit and lets us attribute usage so we can support you.

Keyless access

You can call any endpoint without a key. Keyless requests are limited per IP (see rate limits). This is ideal for trying the API and for low-volume use.

Using a key

Send your key in the x-api-key header:

curl -H "x-api-key: <YOUR_API_KEY>" \
  https://api.ardent.africa/public/v1/stats

const res = await fetch('https://api.ardent.africa/public/v1/stats', {
  headers: { 'x-api-key': '<YOUR_API_KEY>' },
})
const stats = await res.json()

Keys look like ardent_pk_.... Treat a key as a secret: do not commit it to public repositories. Note that if you call the API directly from a browser, the key is visible to users; for public sites, prefer the widgets, which keep the key on our servers.

Requesting a key

Keys are issued on request. Email the Ardent Africa team with your name, the site or app you are building, and roughly how many requests per day you expect. We will send you a key. There is no self-serve key dashboard yet.

Revoking a key

If a key is exposed, contact us and we will revoke it. A revoked key stops working immediately and returns a 401 error.

Last updated: 18 June 2026