Answer a question about one company
Answers one question about one company: whether a named person may represent it
alone (representation), who its computed beneficial owners are and through which
chain each holds (beneficial_owner), its current representatives (officers),
its shareholders (shareholders), its registered office (seat) or its status
(status). The model only reads the question -- its kind, the company and the
person -- and the answer is composed from register data by rules.
Name the company in the question, by its name or its register identity
(HRB 287341); it is resolved as the verify operation resolves it. A question
outside the six kinds of answer, or one that names no company, answers
422 question_not_supported; every refusal (question_not_supported, not_found,
register_identity_ambiguous) is uncharged, and so is a read that fails. A
restricted person is never named, confirmed nor denied.
The answer is not stored: id names this response, and asking again produces
another. An Idempotency-Key is not replayed here (a question can carry a
person's name): a repeated request is answered, and charged, again.
Costs 8 credits.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_live_….
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
One question about one company. The question can carry a person's name: personal data,
never logged, never echoed in an error. A question outside the six kinds of answer, or one
that names no company, answers 422 question_not_supported, uncharged.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.registercheck.de/v1/answers" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "question": "Darf Erika Mustermann bei der Beispiel Beteiligungs GmbH allein unterschreiben?" }'{ "object": "answer", "id": "ans_0spwtbrp21bqf975kbw3sptezw", "created_at": "2026-10-27T09:00:00Z", "question": "Wer ist wirtschaftlich berechtigt bei der Beispiel Beteiligungs GmbH?", "type": "beneficial_owner", "company": { "id": "cmp_4zhsyprpta9gyrwbrt1ee8tzkf", "object": "company", "name": "Beispiel Beteiligungs GmbH", "status": "active", "legal_form": "gmbh", "register": { "court": { "code": "D2601", "name": "Amtsgericht München" }, "type": "HRB", "number": "287341", "formatted": "Amtsgericht München HRB 287341", "country": "DE" }, "address": { "street": "Maximilianstraße 8", "postal_code": "80539", "city": "München", "state": null, "country": "DE", "formatted": "Maximilianstraße 8, 80539 München", "coordinates": null }, "purpose": null, "capital": null, "representation_rule": null, "identifiers": { "euid": null, "lei": null }, "industries": [], "registration_date": null, "founding_date": "2019-04-11", "termination_date": null, "last_register_entry_date": "2026-06-02", "counts": { "current_roles": 1, "documents": 1, "financial_statements": 0 } }, "summary": "Wirtschaftlich berechtigt bei der Beispiel Beteiligungs GmbH ist Erika Mustermann.", "details": [ "Erika Mustermann → Muster Holding GmbH (100 %) → Beispiel Beteiligungs GmbH (60 %)" ], "result": { "beneficial_owners": [ { "id": "per_01hxn3rys1fh58w4d1pb1x9s82", "name": "Erika Mustermann", "percentage": 60, "paths": [ "Erika Mustermann → Muster Holding GmbH (100 %) → Beispiel Beteiligungs GmbH (60 %)" ] } ], "unresolved": null }, "confidence": "high", "sources": [ { "document": "current_register_extract", "retrieved_at": "2026-10-22T06:04:00Z" }, { "document": "shareholder_list", "retrieved_at": "2026-10-20T08:15:00Z" } ]}Overview
One question about one company, answered from register data by rules: whether a named person may represent it alone, who its computed beneficial owners are, its current representatives, its shareholders, its seat or its status.
Overview
Natural persons named in the register, the roles they hold and the shareholdings they hold, across every company.