Request a Transparenzregister extract
Asks the Transparenzregister for the current extract of one legal entity: its registered
beneficial owners (wirtschaftlich Berechtigte), the register's PDF and JSON and, when the
register draws one, the ownership chart. Name the entity by its ekrn, or by company, one
of our companies, which is looked up by its register court, type and number. The extract is
asked for with a connection (POST /connections): name it in connection, or leave it out to
use the workspace's only live connection. The connection decides the environment: a test
connection asks the register's test system, with its published test account.
The register decides an access request in its office hours (weekdays, 7:00 to 19:00 Berlin
time), so an extract can stay pending for hours, at most seven days.
Costs 25 credits, charged only when the extract succeeds. The 25 credits are debited when
the extract is accepted and given back in full when it ends failed or canceled. A test
extract costs the same 25 credits. The register bills separately: for each retrieved
document the Transparenzregister charges 1,65 EUR to your own Transparenzregister account, the
one whose login the connection holds; Registercheck does not pass that fee on and does not
collect it.
Without a connection and without a live connection in the workspace the call answers
409 transparency_register_not_connected; with more than one live connection it answers 400
and asks for connection; with a connection whose login the register refused,
409 transparency_register_login_refused. A company whose register court, type or number we
do not hold answers 422 transparency_register_company_not_resolvable, and a company with a
test connection answers 400: the test system holds none of our companies. While an extract
of the same subject is open on the same connection, another one answers
409 transparency_register_extract_in_progress naming it in existing_id. None of these is
charged.
Send Prefer: wait=55 (RFC 7240) to wait for the register: the call waits up to that many
seconds, at most 55, and answers 200 when the extract ended in that time, with
Preference-Applied: wait=55. An extract still open answers 202 with Location and
Retry-After; read it there, cancel it, or listen for the transparency_register.extract.succeeded,
.failed and .canceled webhooks. Without Prefer the call answers 202 at once.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Header Parameters
wait=N (RFC 7240): wait up to N seconds, at most 55, for the register before answering. The call
answers 200 when the extract ended in that time and 202 otherwise, and says it waited with
Preference-Applied: wait=N. respond-async answers 202 at once. Left out, the call answers 202 at once.
Makes a retry safe. A request repeated with the same key within 24 hours returns
the first successful response (with Idempotent-Replayed: true) instead of acting
twice; an error is not stored, so its retry runs again. Reusing a key with a different
body returns 422; retrying while the first request is still running returns 409.
A response that carries a webhook's signing secret is not stored: retrying such a
POST /destinations answers 409 with existing_id. Use a random UUID.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The legal entity to retrieve, by exactly one of ekrn and company, and the connection to ask with. The
environment is the connection's, so there is no field for it.
Response Body
application/json
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.registercheck.de/v1/transparency-register/extracts" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "ekrn": "DE727032388716", "connection": "conn_01k6hb7xq0fm8a4q2t7bw9c5ve", "include_real_estate": false, "metadata": { "case_id": "KYB-2026-118204" } }'{ "id": "trx_01k6hb8z0yfmx9y02bhrp1tpkf", "object": "transparency_register.extract", "environment": "live", "status": "succeeded", "connection": "conn_01k6hb7xq0fm8a4q2t7bw9c5ve", "subject": { "ekrn": "DE727032388716", "company_id": "cmp_01hxn3rys1fh58w4d1pb1x9s81" }, "include_real_estate": false, "failure": null, "extract": { "source": { "register": "transparenzregister", "environment": "prod", "ekrn": "DE727032388716", "reference_number": "TR-2026-000815", "created_on": "2026-11-17", "request_number": 4711, "basket_number": 815, "document_id": 99, "other_document_ids": [], "retrieved_at": "2026-11-17T10:00:41Z", "is_corrected": false, "corrects": [], "corrected_by": null }, "legal_entity": { "name": "Beispiel Reisen GmbH", "former_names": [], "seat": "Köln", "register": { "type": "HRB", "number": "12345", "court_name": "Amtsgericht Köln" }, "deleted": false, "deleted_on": null }, "notification": { "kind": "sections_20_and_21", "as_registered": "Mitteilung nach §§ 20, 21 GwG" }, "valid_from": { "date": "2024-01-01", "as_registered": "01.01.2024" }, "valid_to": { "date": null, "as_registered": null }, "discrepancy_report": { "state": "none", "completed_on": null, "as_registered": null }, "beneficial_owners": [ { "position": 1, "title": null, "first_names": "Erika", "last_name": "Mustermann", "birth_date": "1964-08-12", "birth_date_as_registered": "12.08.1964", "residence_city": "Köln", "residence_country": "DE", "nationalities": [ "DE" ], "interest": { "kind": "capital_share", "legal_basis": "§ 19 Abs. 3 Nr. 1a GwG", "as_registered": "Beteiligung am Kapital" }, "extent": "60 %" } ], "groups": [], "fictitious_beneficial_owner": null, "real_estate": [], "other_registers": null }, "files": [ { "id": "file_01k6hb9d3rfx0b5s6e8m2n4q7w", "object": "file", "type": "json", "content_type": "application/json", "size": 18342, "sha256": "4f2a7b9c1d3e5f60718293a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4", "url": "https://api.registercheck.de/v1/files/file_01k6hb9d3rfx0b5s6e8m2n4q7w/content", "expires_at": "2026-12-17T10:00:44Z" }, { "id": "file_01k6hb9d3sf4a7c1v9x3z5b8dg", "object": "file", "type": "pdf", "content_type": "application/pdf", "size": 96210, "sha256": "0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9", "url": "https://api.registercheck.de/v1/files/file_01k6hb9d3sf4a7c1v9x3z5b8dg/content", "expires_at": "2026-12-17T10:00:44Z" } ], "credits": { "charged": 25, "refunded": 0 }, "metadata": { "case_id": "KYB-2026-118204" }, "created_at": "2026-11-17T10:00:02Z", "completed_at": "2026-11-17T10:00:44Z", "expires_at": "2026-12-17T10:00:44Z", "redacted": false, "redacted_at": null, "redaction": null}