API referenceTransparency register
Retrieve a Transparenzregister extract
Poll no more than once a minute; Retry-After says when the extract is asked again while it is
queued or pending. An extract belongs to the workspace that asked for it; any other id
answers 404. Thirty days after an extract ended its data and files are deleted (redacted: true, redaction.reason: expired); the extract itself stays, as it does after you redact it.
Free.
Authorization
bearerAuth AuthorizationBearer <token>
Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Path Parameters
extract_id*string
The Transparenzregister extract's id.
Match
^trx_[0-7][0-9a-hjkmnp-tv-z]{25}$Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.registercheck.de/v1/transparency-register/extracts/trx_01k6hb8z0yfmx9y02bhrp1tpkf" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "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}