Get Incorporation
This endpoint retrieves the details of an incorporation
Authorization
To authenticate requests, include an Authorization header with a Bearer token:
Authorization: Bearer <token>
Example: Bearer sk-123e4567-e89b-12d3-a456-426614174000
Path Parameters
incorporation_idstringrequiredThe unique identifier of the incorporation to retrieve.
Example: 123e4567-e89b-12d3-a456-426614174000
Response
resultstringIndicates the outcome of the API request.
Possible values: success or error
messagestringProvides a human-readable message detailing the result of the API request.
Exemple: Incorporation fetched successfully.
incorporation_idstringThe unique identifier for the incorporation in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
namestringThe legal name of the company.
Example: Acme Holdings GmbH
legal_formstringThe type of company incorporated.
Possible values: gmbh or ug
purposestringThe purpose or business objective of the company.
Example: Digital Notarization Services for Germany and Europe
agreement_typestringThe type of articles of association used for the incorporation.
Possible values: musterprotokoll or individual
capitalnumberThe total share capital of the company in EUR.
Example: 25000
shareholders_meeting_quorumnumberThe share of the capital that must be present for a shareholders' meeting to be quorate, in percent.
Example: 75
shareholders_resolution_majoritynumberThe majority required to pass an ordinary shareholders' resolution, in percent.
Example: 75
significant_transactions_majoritynumberThe majority required to approve significant transactions, in percent.
Example: 100
representation_typestringHow the company is represented by its directors.
Possible values: joint, sole or section181
majority_typestringThe majority model used for shareholder decisions.
Possible values: simple, two_thirds or unanimous
notice_period_monthsnumberThe notice period for terminating the company agreement, in months.
Example: 3
additional_servicesarrayAdd-on services the client expressed interest in. Empty when none were selected.
Possible values: authority-registrations, business-liability-insurance, trademark-registration, bookkeeping, tax-advisor-support or business-address
Example: ["authority-registrations", "bookkeeping"]
hrb_numberstringThe commercial register number (Handelsregisternummer) for incorporations.
Example: HRB 123456
court_districtstringThe local court (Amtsgericht) where the company is registered.
Example: Berlin (Charlottenburg)
is_registeredbooleanIndicates whether the company is already officially entered in the commercial register.
Example: true
addressobjectThe address of the company.
streetstringThe street name and number of the company.
Example: Schillerstraße 5
street_second_linestringAdditional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B
zipstringThe postal code of the company.
Example: 80336
citystringThe city of the company.
Example: Munich
statestringThe state of the company.
Example: Bayern
countrystringThe country of the company, specified using ISO 3166-1 alpha-2 country code.
Example: de
business_addressobjectThe business address of the company.
streetstringThe street name and number of the company.
Example: Schillerstraße 5
street_second_linestringAdditional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B
zipstringThe postal code of the company.
Example: 80336
citystringThe city of the company.
Example: Munich
statestringThe state of the company.
Example: Bayern
countrystringThe country of the company, specified using ISO 3166-1 alpha-2 country code.
Example: de
statusstringThe status of the incorporation.
Possible values: initiated, submitted, contact-with-notary-initiated, appointment-confirmed, appointment-completed, waiting-for-deposit-confirmation, completed, blocked, archive, unprocessable
urlstringThe URL of the incorporation.
Example: https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000
directorsarrayAn array of directors managing the company.
first_namestringFirst name of the director.
Example: Maria
last_namestringLast name of the director.
Example: Weber
emailstringEmail address of the director.
Example: maria.weber@example.com
phonestringThe phone number of the director.
Example: +491234567890
dobstringDate of birth of the director in YYYY-MM-DD format.
Example: 1978-03-15
nationalitystringThe nationality of the director, specified using ISO 3166-1 alpha-2 country code.
Example: de
addressobjectAddress of the director.
streetstringThe street name and number of the director.
Example: Schillerstraße 5
street_second_linestringAdditional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B
zipstringThe postal code of the director.
Example: 80336
citystringThe city of the director.
Example: Munich
statestringThe state of the director.
Example: Bayern
countrystringThe country of the director, specified using ISO 3166-1 alpha-2 country code.
Example: de
authoritystringThe director’s signing authority.
Possible values: sole or joint
documentsobjectA collection of documents related to the company.
articles_of_associationarrayThe articles of association for the company.
idstringThe unique identifier for the document in a UUID format.
Example: 07347a09-7fa2-434f-a5f1-ec897f16d4b9
namestringThe file name of the document.
Example: Gesellschafterliste - Acme Holdings GmbH.pdf
typestringThe type of document as specified in the request.
Possible values: musterprotokoll , individual, gesellschafterliste, certificate-of-incorporation or deposit-confirmation
statusstringIndicates the current processing state of the document.
Possible values: submitted, in-review or reviewed
shareholdersobjectAn object containing arrays of individual and entity shareholders, including their details, addresses, and shareholding information.
individualsarrayAn array of individual shareholders.
first_namestringThe first name of the individual shareholder.
Example: Max
middle_namestringThe middle name of the individual shareholder.
Example: Alexander
last_namestringThe last name of the individual shareholder.
Example: Mustermann
emailstringThe email address of the individual shareholder.
Example: max.mustermann@example.com
phonestringThe phone number of the individual shareholder.
Example: +491234567890
dobstringThe date of birth of the individual shareholder. Format: YYYY-MM-DD.
Example: 1985-10-05
nationalitystringThe nationality of the individual shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de
addressobjectThe address of the individual shareholder.
streetstringThe street name and number of the individual shareholder.
Example: Schillerstraße 5
street_second_linestringAdditional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B
zipstringThe postal code of the individual shareholder.
Example: 80336
citystringThe city of the individual shareholder.
Example: Munich
statestringThe state of the individual shareholder.
Example: Bayern
countrystringThe country of the individual shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de
sharesnumberrequiredThe number of shares owned by the shareholder.
Example: 2500
share_percentagenumberThe percentage of shares owned by the shareholder.
Example: 25
entitiesarrayAn array of entity shareholders.
namestringThe name of the entity shareholder.
Example: Max
registration_numberstringThe registration number of the entity shareholder.
Example: Alexander
addressobjectThe address of the entity shareholder.
streetstringThe street name and number of the entity shareholder.
Example: Schillerstraße 5
street_second_linestringAdditional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B
zipstringThe postal code of the entity shareholder.
Example: 80336
citystringThe city of the entity shareholder.
Example: Munich
statestringThe state of the entity shareholder.
Example: Bayern
countrystringThe country of the entity shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de
directorsarrayThe directors of the entity shareholder.
first_namestringThe first name of the entity's director.
Example: John
last_namestringThe last name of the entity's director.
Example: Doe
dobstringDate of birth of the entity director in YYYY-MM-DD format.
Example: 1978-03-15
nationalitystringThe nationality of the entity's director, specified using ISO 3166-1 alpha-2 country codes.
Example: de
emailstringThe email of the entity's director.
Example: john.doe@exemple.com
phonestringThe phone number of the entity director.
Example: +491234567890
addressobjectAddress of the entity director.
streetstringThe street name and number of the entity director.
Example: Schillerstraße 5
street_second_linestringAdditional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B
zipstringThe postal code of the entity director.
Example: 80336
citystringThe city of the entity director.
Example: Munich
statestringThe state of the entity director.
Example: Bayern
countrystringThe country of the entity director, specified using ISO 3166-1 alpha-2 country code.
Example: de
sharesnumberThe number of shares owned by the shareholder.
Example: 2500
share_percentagenumberThe percentage of shares owned by the shareholder.
Example: 25
notarizationobjectDetails about the notarization process.
typestringThe method of notarization.
Possible values: offline or online
expressbooleanRequests expedited notarization.
preferred_timeframenumberThe client's preferred timeframe for notarization, expressed as the number of days from the request date.
Possible values: 7, 14, 30
datestringNotarization date in YYYY-MM-DD format.
Example: 2025-04-16
appointment_statusstringThe current status of the notarization appointment.
Possible values: pending or confirmed
notaryobjectNotary responsible for the notarization.
officestringThe name of the notary’s office.
Example: Notariat Schiller & Partner
namestringThe full name of the notary.
Example: Dr. Anna Becker
emailstringThe email address of the notary.
Example: dr.becker@notariat-schiller.de
phonestringThe contact phone number of the notary.
Example: +49 89 12345678
addressstringThe full address of the notary's office, formatted as street name and number, postal code, city.
Example: Schillerstraße 15, 10117, Berlin
client_referencestringA custom client reference string for tracking purposes.
Example: REF-2025-001
client_preferred_languagestringThe preferred language of the client, specified using ISO 639-1 language codes.
Possible values: en, de, es, fr or it
created_atstringThe timestamp at which the incorporation was created, formatted as an ISO 8601 string (UTC).
Example: 2025-06-15T08:00:00.000Z
{
"response": {
"result": "success",
"message": "Incorporation fetched successfully.",
"incorporation_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Acme Holdings GmbH",
"legal_form": "gmbh",
"purpose": "Durchführung von digitalen Notarisierungsverfahren mit Schwerpunkt auf Deutschland und dem europäischen Raum.",
"agreement_type": "individual",
"capital": 25000,
"shareholders_meeting_quorum": 75,
"shareholders_resolution_majority": 75,
"significant_transactions_majority": 100,
"representation_type": "sole",
"majority_type": "two_thirds",
"notice_period_months": 3,
"additional_services": ["authority-registrations", "bookkeeping"],
"address": {
"street": "Maximilianstraße 15",
"street_second_line": "Apartment 3B",
"zip": "80539",
"city": "Munich",
"state": "Bayern",
"country": "de"
},
"business_address": {
"street": "Goethestraße 18",
"street_second_line": "2. Etage, Büro 5B",
"zip": "50667",
"city": "Cologne",
"state": "Nordrhein-Westfalen",
"country": "de"
},
"status": "submitted",
"url": "https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000",
"directors": [
{
"first_name": "Maria",
"last_name": "Weber",
"email": "maria@weber.de",
"phone": "+491234567890",
"dob": "1978-03-15",
"nationality": "de",
"address": {
"street": "Rathenauplatz 7",
"street_second_line": "1. Stock, Raum 3A",
"zip": "90489",
"city": "Nuremberg",
"state": "Bayern",
"country": "de"
},
"authority": "sole"
}
],
"documents": {
"articles_of_association": [
{
"id": "07347a09-7fa2-434f-a5f1-ec897f16d4b9",
"name": "Gesellschafterliste - Acme Holdings GmbH.pdf",
"type": "gesellschafterliste",
"status": "submitted"
},
{
"id": "5c2f1b84-9e77-4f2a-bd51-3a9e6c0d1f42",
"name": "Gesellschaftsvertrag - Acme Holdings GmbH.pdf",
"type": "individual",
"status": "submitted"
}
]
},
"shareholders": {
"individuals": [
{
"first_name": "John",
"middle_name": "Michael",
"last_name": "Doe",
"email": "john.doe@example.com",
"phone": "+491234567890",
"dob": "1985-07-10",
"nationality": "de",
"address": {
"street": "Lindenallee 12",
"street_second_line": "EG, Büro 1",
"zip": "60594",
"city": "Frankfurt am Main",
"state": "Hessen",
"country": "de"
},
"shares": 12500,
"share_percentage": 50
}
],
"entities": [
{
"name": "Acme Ventures GmbH",
"registration_number": "HRB123456",
"address": {
"street": "Kaiserstraße 21",
"street_second_line": "4. OG, Zimmer 402",
"zip": "60311",
"city": "Frankfurt",
"state": "Hessen",
"country": "de"
},
"directors": [
{
"first_name": "Stefan",
"last_name": "Müller",
"dob": "1985-06-15",
"nationality": "de",
"email": "stefan.mueller@example.com",
"phone": "+49 151 98765432",
"address": {
"street": "Bahnhofstraße 10",
"street_second_line": "Gebäude B, 2. Etage, Raum 204",
"zip": "10115",
"city": "Berlin",
"state": "Berlin",
"country": "de"
}
}
],
"shares": 12500,
"share_percentage": 50
}
]
},
"notarization": {
"type": "online",
"express": false,
"preferred_timeframe": 7,
"date": "2025-05-16",
"appointment_status": "confirmed",
"notary": {
"office": "Notariat Schiller & Partner",
"name": "Dr. Anna Becker",
"email": "dr.becker@notariat-schiller.de",
"phone": "+49 89 12345678",
"address": "Schillerstraße 15, 10117, Berlin"
}
},
"client_reference": "REF-2025-001",
"client_preferred_language": "de",
"created_at": "2025-04-12T08:00:00.0000+00:00"
}
}