registercheckby openlaw group
API referenceTransparency register

List Transparenzregister extracts

GET
/transparency-register/extracts

The extracts this workspace asked for, newest first. Each item is a full extract.

Free.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

status?array<>

Only extracts in these statuses. Repeat the parameter for several (status=queued&status=pending).

connection?string

Only extracts asked for with this connection.

Match^conn_[0-7][0-9a-hjkmnp-tv-z]{25}$
ekrn?string

Only extracts of this legal entity.

Match^DE[0-9]{12}$
company?string

Only extracts asked for by this company.

Match^cmp_[0-7][0-9a-hjkmnp-tv-z]{25}$
limit?integer

Page size, 1 to 100.

Range1 <= value <= 100
Default20
cursor?string

The next_cursor of the previous page; leave it out for the first page. Opaque: pass it back as it came. A cursor from another list, or from the same list with other filters, answers 400 validation_failed naming cursor.

Length1 <= length <= 2000

Response Body

application/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" \  -H "Authorization: Bearer $REGISTERCHECK_API_KEY"
{  "object": "page",  "data": [    {      "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    }  ],  "next_cursor": null}