Skip to main content
GET
JavaScript

Get Transparenzregister extract

Returns the current state of a previously ordered extract. Poll this endpoint after calling the order extract endpoint until status 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 be processing or terminal completed / failed
  • 202 — Extract is still processing (same response schema as 200)
Do not send 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 GwG
  • Funktion 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

Authorization
string
header
required

API Key Authentication Provide your API key as a Bearer token in the Authorization header.

Path Parameters

extract_id
string
required

Extract ID from the submit endpoint. Example: "tre_12345678"

Response

Extract retrieved successfully

Transparenzregister extract resource including processing state, parsed report, and downloadable documents.

id
string
required

Stable extract identifier. Example: "tre_12345678"

status
enum<string>
required

Status of the Transparenzregister extract.

Available options:
completed,
processing,
failed
company_id
string | null

Company identifier associated with this extract request. May be null when using sandbox credentials.

ekrn
string | null

EKRN used to request this extract.

reference_number
string | null

Transparenzregister reference number from the extract.

submitted_at
string<date-time>

Timestamp when extract submission started.

completed_at
string<date-time> | null

Timestamp when extract processing completed.

report
object | null

Parsed Transparenzregister extract report limited to UBO-relevant fields.

documents
object[]

URLs for downloading available extract documents.