registercheckby openlaw group
API referenceTransparency register

Retrieve a Transparenzregister extract

GET
/transparency-register/extracts/{extract_id}

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}