# Topograph — full context for AI agents

> Topograph retrieves company information from public business registers in real
> time across 100+ countries. This file aggregates the core product,
> API, and coverage context so agents can answer questions without additional
> fetches. For always-fresh content, follow the linked pages or query the API.

## What Topograph does

Topograph is a KYB (Know Your Business) data platform. We provide structured,
standardized company data pulled directly from each country's official business
register — legal name, status, legal form, registered address, identifiers,
capital, shareholders, ultimate beneficial owners, directors, activity codes,
and official documents such as articles of incorporation and register extracts.

Our customers are compliance, onboarding, underwriting, and counterparty-risk
teams at regulated financial institutions and fintechs. Typical uses:

- Verify a new corporate customer during onboarding (KYC/KYB).
- Pull officer and UBO data for anti-money-laundering screening.
- Fetch official documents for audit trails.
- Monitor existing counterparties for changes (director exits, insolvency, status changes).

## Coverage

Live connections to business registers in (non-exhaustive): France (INPI/INSEE),
Germany (Unternehmensregister / Handelsregister), the United Kingdom (Companies
House), the Netherlands (KVK), Belgium (KBO/CBE), Italy (Registro Imprese),
Spain (Registro Mercantil), Portugal (RNPC), Norway (Brønnøysundregistrene),
Denmark (CVR), Finland (PRH/YTJ), Sweden (Bolagsverket), Ireland (CRO),
Luxembourg (RCS/LBR), Estonia (äriregister), Romania (ONRC), Czech Republic
(Obchodní rejstřík), Poland (KRS), Singapore (ACRA), and more.

Coverage detail per country, including what data and which documents are
available, lives under <https://www.topograph.co/guides>.

## REST API

Base URL: `https://api.topograph.co`

Authentication: every request needs an `x-api-key` header. Keys are issued per
workspace in the Topograph dashboard. There is no OAuth flow; the key is a
long-lived bearer secret.

### Core endpoints

- `GET /v2/search?country=<ISO-2>&query=<free-text>` — search candidates in a
  country's register by name or identifier. Optional `stream=true` for
  Server-Sent Events; optional `transliterate=true` to romanize non-Latin input.
- `POST /v2/company` — submit a profile request. Body:
  `{"countryCode":"FR","companyId":"832940670","data":["profile","shareholders","legalRepresentatives","documents"]}`.
  Response contains `requestId`.
- `GET /v2/company/{requestId}` — poll the request. Returns `status` (`pending`
  | `succeeded` | `failed`) plus resolved data blocks. Poll every 2–5 seconds;
  most requests resolve in under 30 seconds.
- `POST /v2/monitors`, `GET /v2/monitors`, `GET /v2/monitors/{id}`,
  `DELETE /v2/monitors/{id}` — subscribe to change events on a company.
- `GET /v2/pricing` — country coverage and per-datapoint prices.
- `GET /v1/health` — liveness probe.

Full spec: <https://docs.topograph.co/openapi.json>.

### Errors and rate limits

- `401` — missing or invalid `x-api-key`.
- `402` — account out of credits. The user must top up in the dashboard.
- `429` — over quota. Respect the `Retry-After` header before retrying.
- `5xx` — server error. The body contains a `requestId`; surface it to the user.

## Discovery surfaces

- `https://www.topograph.co/robots.txt` — Content-Signal: `ai-train=no, search=yes, ai-input=yes`.
- `https://www.topograph.co/.well-known/api-catalog` — RFC 9727 linkset.
- `https://www.topograph.co/.well-known/agent-skills/index.json` — skills index.
- `https://www.topograph.co/.well-known/agent-skills/topograph-api/SKILL.md` — skill instructions.
- Link headers on every HTML response advertise these surfaces per RFC 8288.
- WebMCP tools registered in the browser (`navigator.modelContext.registerTool`): `search_companies`, `book_demo`.
- Markdown mirror: append `.md` to any page URL or send `Accept: text/markdown`.

## Key pages

- Homepage: <https://www.topograph.co/> (append `.md` or send `Accept: text/markdown` for markdown)
- Blog: <https://www.topograph.co/blog>
- Country guides: <https://www.topograph.co/guides>
- Company directory: <https://www.topograph.co/companies>
- Developer docs: <https://docs.topograph.co>
- Status: <https://status.topograph.co/>

## Who we are

Topograph is a company building KYB infrastructure. Book a demo at
<https://www.topograph.co#book-demo>.