registercheckby openlaw group
API referenceTransparency register

Request a Transparenzregister extract

POST
/transparency-register/extracts

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
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer rc_prod_….

In: header

Header Parameters

Prefer?string

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.

Idempotency-Key?string

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.

Length1 <= length <= 255

Request 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}