Billing
What you pay, and when: EUR 0.005 per successful enrichment excluding taxes, what is never billed, and how to read a call's usage without counting it twice.
EUR 0.005 per successful enrichment, excluding applicable taxes. No monthly minimum, no subscription fee, no included bundle: you pay for what resolved, and for nothing else. Sandbox is free and never bills anything.
What is billable
An enrichment is billable when it resolved.
| Result | Billable |
|---|---|
resolved | yes, 1 unit |
refresh_recalculated | yes, 1 unit |
partial | no |
not_found | no |
A replay of a call already settled (same Idempotency-Key, or same external_transaction_id) | no |
engine_error, rate_limited, any 4xx | no |
A GET read | no, never |
Reading a call's usage
Every successful POST response carries a usage object stating what the call cost:
"usage": { "billable": true, "units": 1, "deduplicated": false, "deduplicated_by": null }JSON| Field | Meaning |
|---|---|
billable | The call is billed. Always false in Sandbox. |
units | The units the call carries: 1 for resolved and refresh_recalculated, 0 otherwise. |
deduplicated | true when the response comes from economic deduplication (same external_transaction_id, same input). |
deduplicated_by | external_transaction_id when deduplicated is true, null otherwise. |
A replay by external_transaction_id is visible in the body: deduplicated: true, billable: false, units: 0.
A replay by Idempotency-Key returns the memorised body of the first response, usage included. If the first response was billed, the replay still shows billable: true, although nothing new was billed. You recognise this case by the Noryo-Idempotency-Replayed: true header: if you keep your own consumption count, ignore usage on those responses.
A GET read carries no usage object but two separate ones: retrieval (what this read costs, always billable: false and units: 0) and original (what the enrichment cost when it happened). See Read an enrichment.
Getting to Production
Production is not self-service. You file an application, a person at Noryo reviews it, and the decision is theirs. Before that review you must have registered a payment method: Noryo does not open a Production it could not collect on.
Once approved, usage is metered as you call, each calendar month is closed automatically, and the invoice is collected from your registered payment method. Platform does not create Production keys: it only issues Sandbox keys. See Going live.
A small invoice may show as settled without a debit
Very small amounts are not charged immediately: our payment provider carries them and collects them with the first invoice that clears its own minimum. So an invoice can appear settled in a month where nothing left your account. The total eventually collected is exactly the sum of what you consumed, never more.
Following your consumption
The Usage page of Platform shows, for the last thirty days, the number of settled calls and the units per day, broken down by status. See Observability.
Published on 2026-10-08 21:04 UTC (version 1).