[ Get started ]

Authentication

Fomo API uses account-scoped API keys to authenticate requests. Keys are generated from your dashboard after signing in with Google.

Keep API keys private

Never expose an API key in frontend code, public repositories, browser bundles or client-side environment variables.

Create an API key

Open the dashboard, select Create key and give the key a recognizable name. The complete key is shown once. Copy it before closing the dialog.

The recommended authentication method is the X-API-Key request header.

request header

X-API-Key: fomo_live_YOUR_API_KEY

API keys can also be sent as a Bearer token through the standard Authorization header.

authorization header

Authorization: Bearer fomo_live_YOUR_API_KEY

StatusDescription

401API key is missing, invalid or expired.

402The account does not have enough credits for the request.

403The account or API key cannot access the resource.

429The key exceeded the five requests per second limit.

API keys are stored as secure hashes. If a key is lost, delete it from the dashboard and generate a replacement.