registercheckby openlaw group
Understand the data

Glossary

One word per concept — the word in the path, in the `object` field, in the id and in the reference.

The API uses one word for each thing the register holds, and it is the same word everywhere: in the path, in the object field of the response, in the id prefix, in the API reference and on these pages. If you find two words for one thing, or one word for two things, that is a bug — tell us.

The words

GermanWord and objectIdPaths
Unternehmencompanycmp_…/companies/{company_id}
Person (natürliche Person)personper_…/persons/{person_id}
Funktion: Geschäftsführer, Vorstand, Prokurist, Liquidator, persönlich haftender Gesellschafterrolerol_…/companies/{company_id}/roles, /persons/{person_id}/roles
Beteiligung, Kommanditeinlageshareholdingshr_…/companies/{company_id}/shareholders, /companies/{company_id}/holdings, /persons/{person_id}/holdings
Beteiligungsbaumownership_tree—/companies/{company_id}/ownership-tree
Wirtschaftlich Berechtigte, rechnerischbeneficial_owner_analysis—/companies/{company_id}/beneficial-owners
KYB-Berichtkyb_reportkyb_…/companies/{company_id}/kyb-report
Änderung, Ereigniseventevt_…/events, /events/{event_id}, /companies/{company_id}/events
Registereintragungregister_entryrge_…inside an event's source, and as an item of /companies/{company_id}/register-entries
Ereignistypevent_typeits name, e.g. company.name.changed/event-types
Ereignisgruppeevent_groupits name, e.g. representation/event-groups
Überwachungmonitormon_…/monitors
Zustellziel (E-Mail-Adresse, Webhook-URL oder Slack-Kanal)destinationdst_…/destinations
Zustellungdeliverydlv_…/deliveries; also the body of every monitor webhook
Listelistlst_…/lists
Listeneintraglist_itemlsi_…/lists/{list_id}/items
Dokument (Registerauszug, Gesellschafterliste, Satzung …)documentdoc_…/companies/{company_id}/documents
Jahresabschlussfinancial_statementfst_…/companies/{company_id}/financial-statements
Neugründungformationcmp_…, the company's own id/formations
Kurzprofil (Suchtreffer, Vorschlag)summarythe company's or person's id/search/companies, /search/persons, /search/suggestions, /search/companies/filter
Kontoaccountwsp_…, your workspace/account
Rechtsformlegal_formits code, e.g. gmbh/legal-forms
Registergerichtcourtits code, e.g. D2601/courts
Funktionsart (Geschäftsführer, Vorstand, Prokurist, …)role_typeits code, e.g. managing_director/role-types
Wirtschaftszweig (WZ 2025)industryits code, e.g. 62.10/industries

A role is an office: someone who acts for the company. A shareholding is an interest: someone who holds part of it. A Kommanditist holds a shareholding of type: limited_partner and no role. A Komplementär appears twice, because the register states both: a general_partner role (they represent the company) and a general_partner shareholding (they hold an interest in it).

The direction of a shareholding is in the path, not in the object: /companies/{company_id}/shareholders lists who holds shares in that company; /companies/{company_id}/holdings and /persons/{person_id}/holdings list what that company or person holds in others. Every one of them returns shareholding objects.

The chain behind a monitor is monitor → event → delivery → destination: a monitor matches events about its company, and each delivery sends one or more of those events to one destination.

Ids

Every id is the kind of thing it names, then _, then 26 characters, for example cmp_01h2xcejqtf2nbrexx3vqjhp41. The prefix is part of the id: store the whole string. An endpoint that takes a company id refuses a person id with 400 validation_failed, so a mixed-up id fails loudly instead of answering 404.

Codes keep their own form: legal forms (gmbh), courts (D2601), role types (managing_director), event types (company.name.changed), event groups (representation), register types (HRB).

Ids are TypeIDs (version 0.3.0). If you stored ids before they had prefixes, the migration guide converts them.

A WZ 2025 code keeps the form Destatis publishes (A, 62.10, 01.11.0). GET /industries lists every code, with its German title, its level and its parent.

Shapes that recur

party

Wherever a response names a company or a person it is not itself about — the holder of a role, the holder of a shareholding, the subject of an event — it uses the same three fields:

{ "object": "person", "id": "per_01hxn3rys1fh58w4d1pb1x9s82", "name": "Erika Mustermann" }

object is company or person. id is null when the register names a holder we could not match to a record, such as a company registered abroad; name is then the name as filed. For anything else about the party, read its own record.

subject

The company or person an event, a company monitor or a list item is about. It is a party. A search monitor's subject is the search instead. When you create one of those, you send subject_id (a monitor also takes register, prompt or filter).

page

Every list and every search answers the same envelope:

{ "object": "page", "data": [], "next_cursor": "eyJ2IjoxLCJrIjoi…" }

Search adds total_count (suggestions do not). A page of roles, shareholders or holdings adds extract. See Pagination.

extract

How current the data behind a page is, because roles and shareholders are read from filed documents:

statusMeaning
parsedThe latest filed document has been read; fetched_at says when and document_id which.
processingWe are reading it now. Ask again in a few minutes.
not_filedThe register holds no such document for this company. An empty page is the answer.
not_fetchedWe have not fetched it from the register.
failedWe fetched it and could not read it.
unknownWe could not tell where the data stands. It says nothing about the register; ask again later.

summary

What search returns: a short profile with object: "summary" and type: "company" or type: "person". Apart from object and type, every field in it has the same name and meaning as in the full record, so the rest of a summary is a subset of a company or person. One exception: a company summary's registration_date is always null today. Read the full record by its id.

Errors

An error is a problem document (RFC 9457) with a code, not an object with an object field. See Errors.

Register identity

A company is entered at one register court (register.court), in one register type (register.type), under one number (register.number); register.formatted writes the three the way it is usually cited, e.g. Amtsgericht München HRB 999999. A few old entries carry no register type; their register.type is null.

register.typeRegister
HRAHandelsregister Abteilung A: sole traders and partnerships (e.K., OHG, KG)
HRBHandelsregister Abteilung B: corporations (GmbH, UG, AG, KGaA, SE)
GnRGenossenschaftsregister: cooperatives
PRPartnerschaftsregister: partnerships of the liberal professions
VRVereinsregister: registered associations
GsRGesellschaftsregister: registered civil-law partnerships (eGbR)

A register number is unique only within one court and one type, so the company id is the key to store.

Words you will not find

Some words the API used before October 2026 are gone, each replaced by one of the words above. The migration guide lists every one, old next to new.

On this page