---
title: "Get Transparenzregister extract"
method: GET
path: "/v1/transparenzregister/extracts/{extract_id}"
tags: ["v1"]
---

# Get Transparenzregister extract

`GET /v1/transparenzregister/extracts/{extract_id}`

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.

## Path parameters

- `extract_id` string, required

## Response `200`

Extract retrieved successfully

- TransparenzregisterExtract — Transparenzregister extract resource including processing state, parsed report, and downloadable documents.
  - `id` string, required — Stable extract identifier. Example: "tre_12345678"
  - `status` 'completed' | 'processing' | 'failed', required — Status of the Transparenzregister extract.
  - `company_id` string, nullable — Company identifier associated with this extract request. May be null when using sandbox credentials.
  - `ekrn` string, nullable — EKRN used to request this extract.
  - `reference_number` string, nullable — Transparenzregister reference number from the extract.
  - `submitted_at` string, date-time — Timestamp when extract submission started.
  - `completed_at` string, date-time, nullable — Timestamp when extract processing completed.
  - `report` TransparenzregisterReport, nullable — Parsed Transparenzregister extract report limited to UBO-relevant fields.
    - `created_at` string, date, nullable — Extract creation date. Format: ISO 8601 (YYYY-MM-DD)
    - `notice_type` string, nullable — Type of Transparenzregister notice.
    - `validity` TransparenzregisterValidity, nullable
      - `from` TransparenzregisterValidityPoint, nullable
        - `date` string, date, nullable — Format: ISO 8601 (YYYY-MM-DD)
        - `note` string, nullable
      - `until` TransparenzregisterValidityPoint, nullable
        - `date` string, date, nullable — Format: ISO 8601 (YYYY-MM-DD)
        - `note` string, nullable
    - `status_flags` TransparenzregisterStatusFlags, nullable
      - `deleted` boolean
      - `deletion_date` string, date, nullable — Format: ISO 8601 (YYYY-MM-DD)
      - `discrepancy_note` string, nullable
      - `corrected_references` string[]
      - `corrected_by_reference` string, nullable
    - `groups` TransparenzregisterGroup[]
      - `position` integer
      - `interest_type` string, nullable
      - `description` string, nullable
    - `ubos` TransparenzregisterUBO[]
      - `position` integer
      - `natural_person` TransparenzregisterUBONaturalPerson, nullable
        - `title` string, nullable
        - `first_name` string, nullable
        - `last_name` string, nullable
        - `full_name` string, nullable
        - `date_of_birth` string, date, nullable — Format: ISO 8601 (YYYY-MM-DD)
        - `nationalities` string[] — ISO 3166-1 alpha-2 nationality codes where available.
        - `city` string, nullable
        - `country` string, nullable
      - `interest` TransparenzregisterUBOInterest, nullable
        - `type` string, nullable
        - `scope` string, nullable
        - `percentage` number, double, nullable
    - `fictional_ubo_reason` string, nullable — Reason indicating no natural person UBO could be determined.
  - `documents` TransparenzregisterDocument[] — URLs for downloading available extract documents.
    - `document_id` string, uuid, required — Stable UUID for this document.
    - `url` string, required — Download URL for the document. Example: "https://api.example.com/download/abc123"
    - `format` string, required — Format of the downloadable document. Example: "xml", "pdf", "json"
    - `filename` string, required — Suggested filename for the download. Example: "registerauszug_company_12345.pdf"

## Other responses

- `202` — Extract is still processing
- `400` — Bad Request - Invalid extract ID or parameters
- `401` — Unauthorized - Authentication required
- `404` — Not Found - Extract not found
- `500` — Internal Server Error - An error occurred while processing the request

---

[API](https://skmtc.net/oregister/apis/openregister-api.md) · [All operations](https://skmtc.net/oregister/apis/openregister-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oregister/openregister-api/revisions/d1fcaf6d6ca0/schema)