Get extract
Get the results of a Transparenzregister extract request. This endpoint handles all internal complexity including polling request status, selecting all available documents, creating Transparenzregister baskets, and returning download URLs when ready. If the request is still processing, it will return a pending status. Polling reuses the credential mode stored on the extract at create time. Sandbox extracts keep using the Transparenzregister test client automatically; no credential header is accepted on this endpoint.
Get Transparenzregister extract
Returns the current state of a previously ordered extract. Poll this endpoint after calling the order extract endpoint untilstatus is completed or failed.
Recommended polling interval: every 5–10 seconds. Most extracts complete within 5-60 seconds, but can take longer depending on Transparenzregister availability.
200— Extract retrieved; may still beprocessingor terminalcompleted/failed202— Extract is still processing (same response schema as200)
X-Credential-Name on this request. Polling reuses the credential mode stored when the extract was created; sandbox extracts keep using the Transparenzregister test client automatically.
Once status is completed, results are cached — you can fetch the same extract_id again without re-processing or incurring additional costs.
Cost: 0 credits
Status values
Top-level extract fields
report — parsed register entry
Derived from the JSON variant of the extract document.
ubos[].interest.type — enumeration
Values are the full German strings returned by the register, including legal references. Examples include:
Beteiligung an der Vereinigung selbst, insbesondere der Höhe der Kapitalanteile (§ 19 Abs. 3 Nr. 1a GwG)Beteiligung an der Vereinigung selbst, insbesondere der Stimmrechte (§ 19 Abs. 3 Nr. 1a GwG)Ausübung von Kontrolle auf sonstige Weise (§ 19 Abs. 3 Nr. 1b GwG)Treugeber (Settlor), Trustee oder Protektor (§ 3 Abs. 3 Nr. 1 GwG)Mitglied des Vorstands der Stiftung (§ 3 Abs. 3 Nr. 2 GwG)Begünstigter (§ 3 Abs. 3 Nr. 3 GwG)Person mit sonstigem beherrschendem Einfluss auf Vermögensverwaltung / Ertragsverteilung (§ 3 Abs. 3 Nr. 5 GwG)Sonstige Funktion des gesetzlichen Vertreters (§ 19 Abs. 3 Nr. 1c GwG)Funktion des geschäftsführenden Gesellschafters oder Partners (§ 19 Abs. 3 Nr. 1c GwG)Person mit beherrschendem Einfluss nach § 3 Abs. 3 Nr. 6 GwGFunktion des gesetzlichen Vertreters, geschäftsführenden Gesellschafters oder Partners (§ 19 Abs. 3 Nr. 1c GwG)Person mit beherrschendem Einfluss auf eine Vereinigung, die Mitglied des Vorstands der Stiftung ist oder die als Begünstigte der Stiftung bestimmt worden ist (§ 3 Abs. 3 Nr. 6a GwG)Person mit beherrschendem Einfluss auf eine Vereinigung, die als Treugeber (Settlor), Verwalter von Trusts (Trustee) oder Protektor handelt oder die als Begünstigte der Rechtseinheit bestimmt worden ist (§ 3 Abs. 3 Nr. 6b GwG)
fictional_ubo_reason — upstream grundFiktiveWb
When set, typical values include:
Es wurde keine natürliche Person ermittelt, die die Voraussetzungen eines wirtschaftlich Berechtigten nach § 3 Abs. 1 oder Abs. 2 S. 1 - 4 GwG erfüllt.Die Ermittlung eines wirtschaftlich Berechtigten nach § 3 Abs. 1 oder Abs. 2 S. 1 - 4 GwG war nach Durchführung umfassender Prüfungen nicht möglich.keine Angabe
documents[]
Authorizations
API Key Authentication Provide your API key as a Bearer token in the Authorization header.
Path Parameters
Extract ID from the submit endpoint. Example: "tre_12345678"
Response
Extract retrieved successfully
Transparenzregister extract resource including processing state, parsed report, and downloadable documents.
Stable extract identifier. Example: "tre_12345678"
Status of the Transparenzregister extract.
completed, processing, failed Company identifier associated with this extract request. May be null when using sandbox credentials.
EKRN used to request this extract.
Transparenzregister reference number from the extract.
Timestamp when extract submission started.
Timestamp when extract processing completed.
Parsed Transparenzregister extract report limited to UBO-relevant fields.
URLs for downloading available extract documents.

