What uses of the API are metered and cost money?
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:
| Endpoint | Cost |
|---|---|
/match | 0.10 EUR × queries in the request |
/reconcile | 0.10 EUR × queries in the request |
/search | 0.10 EUR per request |
/entities | Free |
/statements | Free |
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.