Get started

Authentication

How to authenticate requests to the Clarifo Data API.

Every request must carry a valid Clarifo API key. Keys start with the prefix clf_ and are 52 characters long.

Sending the key

The Data API accepts the key in either of two headers. The bearer form is the documented public contract; X-API-Key is provided for clients that cannot easily set Authorization (e.g. some legacy OpenAPI tooling).

Authorization (preferred)
Authorization: Bearer clf_3a7f8b0d…

Managing keys

Keys are created from the Clarifo web app under Settings → API keys. Each user can hold up to 5 active keys.

  • The raw key value is shown only once, at the moment of creation. Save it immediately.
  • Revoked keys stop working within seconds and cannot be reactivated — create a new one instead.
  • Each key carries the same monthly quota that comes with your plan (Pro / API / Custom).

What gets verified

On every call we check, in order:

  1. The key exists and is active (not revoked).
  2. The key has not expired (if an expiry was set when issued).
  3. The caller is within the per-key rate limit.
  4. The caller is within the monthly quota for the Data API surface.

Subscription gating

API access is bundled with the Pro, API and Custom plans. On the free plan, key-creation calls return 403. Upgrade at clarifo.com/pricing.

Example

bash
curl https://api.clarifo.com/api/v1/data/filings/search \
  -H "Authorization: Bearer $CLARIFO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company": "Neste", "limit": 1}'