Skip to main content
Topograph prices are country-specific and can change as coverage evolves. Use Coverage and pricing for the live human-readable catalog and GET /v2/pricing for application logic.

Live pricing catalog

View current country coverage, data block availability, document coverage, sources, and prices.

​
How billing works

Topograph bills by data block and document. A data block is the smallest billable unit for structured data in a country. A block can cover one or more datapoints, depending on how that country’s sources are packaged. Common datapoints include:
  • company
  • legalRepresentatives
  • otherKeyPersons
  • establishments
  • shareholders
  • subsidiaries
  • ultimateBeneficialOwners
  • availableDocuments
  • graph
Search and request-result polling by requestId are not billed as new company data requests. Global search is billed per search, and only when it finds one good candidate (status: resolved). availableDocuments lists document metadata; document downloads are billed only when you request specific document IDs.

​
24-hour deduplication

When you request the same billable block for the same company within 24 hours, Topograph deduplicates the charge for your account. The later request links to the previous billing event rather than creating a duplicate charge. This matters for multi-step flows: you can request company first, then request documents or additional datapoints later without accidentally rebilling blocks that were already covered inside the deduplication window. Prefill and verification are separate products, so the deduplication applies within one mode: a block bought in prefill and then in verification is billed in each mode. Accounts on an earlier contract keep the terms of that contract.
Store requestId values. GET /v2/company/{requestId} retrieves the latest result and refreshes signed document URLs without starting a new billable request.

​
Included documents

Some official documents come from the same register order as a data block. Where the register charges for that order, a document bought with its block, in the same request or within 24 hours of it, costs only a small fixed fee instead of its full price, because the order is already paid. Where the register charges nothing, the document and the data are separate products, each at its own price. Which documents share an order is country-specific and document-specific. The live pricing page shows each document’s price alone and with its data. Accounts on an earlier contract keep the terms of that contract.

​
Budget caps

Use maxBudget to cap the cost of the data blocks in a /v2/company request, measured against your block prices. Documents requested in the same call are not counted against it, because their cost is only known at retrieval time. If not every requested block fits, Topograph prioritizes blocks in this order:
  1. Blocks that cover company (highest priority)
  2. Blocks that cover legalRepresentatives
  3. Blocks that cover ultimateBeneficialOwners
  4. Blocks that cover shareholders
  5. Blocks that cover subsidiaries
Datapoints whose block exceeds the remaining budget are marked as failed with budget_exceeded, while the other datapoints continue normally.
Use GET /v2/pricing before submitting budget-capped requests when your application needs to predict which blocks will fit.

​
Retrieve pricing programmatically

Use GET /v2/pricing to retrieve country-specific availability and pricing in your application.
The response includes:
  • Data blocks and the datapoints each block covers.
  • Mode availability for verification and prefill.
  • Whether a mode is authoritative.
  • Included document metadata.
  • Flat per-datapoint availability for quick lookups.
  • Variable-pricing markers when final document or register costs are known only at request time.
GET /v2/catalog lists every country with its datapoints, documents and prices. Called with your API key, it returns your account’s own prices, negotiated prices included. Called without one, it returns the published prices. Prices follow your plan: /v2/pricing, /v2/catalog, document prices and webhooks always quote the prices of the plan your account is on.

​
Best Practices

Use the live pricing page for human review and /v2/pricing for runtime decisions.
Split requests across your flow when useful. Duplicate covered blocks within the deduplication window are not charged again.
Always store the requestId from your requests. You can use it to retrieve the same data later at no additional cost, regardless of when you make the follow-up request.
When a document is included with a data block, requesting them together can simplify your flow.

​
Account billing

Manage credits, payment methods, and invoices from the Topograph dashboard. For custom plans or high-volume usage, contact support.