Frequently asked questions

What uses of the API are metered and cost money?

Category: API · Last updated: · Permalink

The OpenSanctions API bills usage per logical query, not per HTTP request:

EndpointCost
/match0.10 EUR × queries in the request
/reconcile0.10 EUR × queries in the request
/search0.10 EUR per request
/entitiesFree
/statementsFree

A /match request can bundle up to 100 queries — one per entity you are screening — and each query in the batch is billed individually. Batching queries into fewer HTTP requests is a technical convenience, not a way to reduce cost: screening 1,000 entities counts as 1,000 billable queries whether you submit them one at a time or in batches of 100.

Only successful calls (HTTP response code 200) are billed. Non-successful calls, whether caused by client or server errors, are always free.

You can review your API usage costs on the account overview page.

The on-premise API (yente) does not use metering: you only need a bulk data license to have the right to use the data.

Related questions

« Back to full FAQ index