public read-only API · REST + MCP
One company object, available in code.
Resolve a legal entity, inspect its match state and keep official provenance attached. The public slice works without a key; deeper data and document access begin from a selected company.
working public surface
Endpoints
GET /api/v1/resolve?q={query}&country={country} Public. Returns an evidence-backed match, verified candidates, jurisdiction_required when a live register must be chosen, or source_check_required. Unknown values are never inferred.
GET /api/v1/companies/gb/08480771 Public. Looks up the sourced example by jurisdiction and registration number.
GET /api/v1/coverage/fr Public. Returns France authority, source role, rights, health and the honest current materialization state.
POST /api/mcp Public read-only MCP transport exposing the same company resolver and jurisdiction coverage metadata to agents.
$ curl --get \\ --url "https://getcompanydocs-site.azize-seyt.workers.dev/api/v1/resolve" \\ --data-urlencode "q=08480771" { "status": "resolved", "query": { "value": "08480771", "normalized": "08480771", "jurisdiction_code": null }, "match": { "entity_id": "gcd_GB_08480771", "jurisdiction": { "code": "GB", "name": "United Kingdom" }, "registration_number": "08480771", "legal_name": "STRIPE PAYMENTS UK LTD", "status": "Active", "company_type": "Private limited company", "incorporated_on": "2013-04-09", "registered_office": "9th Floor, 107 Cheapside, London, EC2V 6DN", "sic_codes": ["63990"], "latest_accounts_made_up_to": "2024-12-31", "source": { "registry": "Companies House", "url": "https://find-and-update.company-information.service.gov.uk/company/08480771", "checked_at": "2026-07-11T15:00:00Z" }, "links": { "browser": "/company/gb/08480771/stripe-payments-uk-ltd", "api": "/api/v1/companies/gb/08480771", "filing_history": "https://find-and-update.company-information.service.gov.uk/company/08480771/filing-history" }, "record": { "schema_version": 1, "updated_at": "2026-07-11T15:00:00Z" } }, "meta": { "match_type": "exact_alias", "verified_matches": 1 }, "api": { "version": "v1", "generated_at": "2026-07-11T15:00:00Z", "data_mode": "verified_index_snapshot" } }
No API key is required for the public resolver. CORS is enabled for this read-only surface. The live api.generated_at value is the response time. A no-country miss returns jurisdiction_required; a source-specific miss returns source_check_required. Neither response invents entity fields. France coverage stays not_loaded until an approved complete snapshot publishes real counts.
honest jurisdiction selection
A company name does not imply a country.
{
"status": "jurisdiction_required",
"query": {
"value": "Example Company",
"normalized": "example company",
"jurisdiction_code": null
},
"match": null,
"supported_jurisdictions": [{
"code": "FR",
"name": "France",
"resolution_mode": "live_official"
}],
"reason": "jurisdiction_required",
"message": "Choose a jurisdiction before GCD checks a live official register. No jurisdiction has been inferred from the company name.",
"next": { "browser": "/company?q=Example+Company" },
"api": {
"version": "v1",
"generated_at": "2026-07-11T15:00:00Z",
"data_mode": "verified_index_snapshot"
}
}published pricing
Source fees stay separate.
Search / resolveFreePublic read-only endpoint; names and registration numbers.
Current shared profile€0.10Published rate for expanded access; rereads of the same company version are free.
Live register refresh€1 + official feeExact source fee shown separately before confirmation.
List documentsFreeSee the catalogue before requesting retrieval.
Retrieve official document€1 + official feeExpanded capability, requested from the selected company page.
Failed / unsupportedFreeNo charge when GCD cannot return the requested capability.
Public resolver works nowUnsupported requests are freeOfficial fees remain separate