Quickstart
From an API key to a company record in about two minutes.
1. Get a key
API keys are created in the app, not through the API.
Open the Usage (API & Nutzung) page and sign in.
Choose Create API key, give it a name that says where it will be used
(billing-service-prod beats key 1), and create it.
Copy the key. It is shown once. If you lose it, revoke it and create another — there is no way to read an existing key back.
A free account comes with 50 credits for 30 days: enough to try search (1) and company reads (10).
2. Call the API
Every request goes to https://api.registercheck.de/v1 and carries your key as a
bearer token.
curl "https://api.registercheck.de/v1/search/companies?name=Enduro&limit=3" \
-H "Authorization: Bearer $REGISTERCHECK_API_KEY"Python’s standard library is blocked at our edge
Requests sent with the default urllib.request user agent are rejected by our CDN with
a 403 and the body error code: 1010 — before they reach the API. Use requests,
httpx, or set an explicit User-Agent header on your urllib requests.
3. Read the response
/search/companies returns candidates with a stable id. That id is what every other
endpoint takes.
{
"object": "page",
"data": [
{
"object": "summary",
"type": "company",
"id": "cmp_63b6n0c6p09pnsrr6nrtd0dzsc",
"name": "Enduro Reise & Training GmbH",
"status": "active",
"legal_form": "gmbh",
"register": {
"court": { "code": "D2505", "name": "Amtsgericht Memmingen" },
"type": "HRB",
"number": "13557",
"formatted": "Amtsgericht Memmingen HRB 13557",
"country": "DE"
},
"address": { "city": "Memmingen" },
"registration_date": null,
"founding_date": "2011-06-14"
}
],
"next_cursor": null,
"total_count": 4
}Every list answers in this shape: the items in data, and next_cursor to walk further
(null on the last page). A register number is a string here and everywhere else — "13557", not
13557 — because a register number is an identifier, not a quantity.
4. Fetch the full record
curl "https://api.registercheck.de/v1/companies/cmp_63b6n0c6p09pnsrr6nrtd0dzsc" \
-H "Authorization: Bearer $REGISTERCHECK_API_KEY"You get the register entry as it stands today: name, registered office and address, stated
purpose, share capital, legal form, register identity, and a counts block saying how many
current roles, documents and financial statements exist — so you know whether a sub-resource is
worth a call before you spend a credit on it.
Roles, documents, statements, ownership and history are separate endpoints rather than
one large object. Add ?expand=roles if you want the first page of roles inline at
no extra charge.