API referenceTransparency register
List Transparenzregister extracts
The extracts this workspace asked for, newest first. Each item is a full extract.
Free.
Authorization
bearerAuth AuthorizationBearer <token>
Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Query Parameters
status?array<>
Only extracts in these statuses. Repeat the parameter for several (status=queued&status=pending).
connection?string
Only extracts asked for with this connection.
Match
^conn_[0-7][0-9a-hjkmnp-tv-z]{25}$ekrn?string
Only extracts of this legal entity.
Match
^DE[0-9]{12}$company?string
Only extracts asked for by this company.
Match
^cmp_[0-7][0-9a-hjkmnp-tv-z]{25}$limit?integer
Page size, 1 to 100.
Range
1 <= value <= 100Default
20cursor?string
The next_cursor of the previous page; leave it out for the first page. Opaque: pass it
back as it came. A cursor from another list, or from the same list with other filters,
answers 400 validation_failed naming cursor.
Length
1 <= length <= 2000Response Body
application/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" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "data": [ { "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 } ], "next_cursor": null}