Initiate Incorporation
This endpoint creates an incorporation request for a company in Germany such as a GmbH or UG, including company details, shareholders, and directors.
Authorization
To authenticate requests, include an Authorization header with a Bearer token:
Authorization: Bearer <token>
Example: Bearer sk-123e4567-e89b-12d3-a456-426614174000
Body
namestringrequiredThe legal name of the company.
Example: Beglaubigt.de GmbH
legal_formstringrequiredThe type of company being incorporated.
Possible values: gmbh or ug
Note: The matching legal-form suffix is appended to name automatically — Beglaubigt.de becomes Beglaubigt.de GmbH (or Beglaubigt.de UG (haftungsbeschränkt)). If the suffix is already present it is left untouched.
purposestringrequiredThe purpose or business objective of the company.
Example: Digital Notarization Services for Germany and Europe
addressobjectrequiredThe address of the company.
streetstringrequiredThe 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
zipstringrequiredThe postal code of the company.
Example: 80336
citystringrequiredThe city of the company.
Example: Munich
statestringThe state of the company.
Example: Bayern
countrystringrequiredThe country of the company, specified using ISO 3166-1 alpha-2 country code.
Example: de
business_addressobjectrequiredThe business address of the company.
streetstringrequiredThe 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
zipstringrequiredThe postal code of the company.
Example: 80336
citystringrequiredThe city of the company.
Example: Munich
statestringThe state of the company.
Example: Bayern
countrystringrequiredThe country of the company, specified using ISO 3166-1 alpha-2 country code.
Example: de
capitalnumberrequiredThe total share capital of the company in EUR. Must be a whole number (no decimals).
Minimum: 25000 for gmbh, 1 for ug
Example: 25000
shareholdersobjectrequiredAn object containing arrays of individual and entity shareholders, including their details, addresses, and shareholding information.
Note: At least one shareholder is required — supply individuals, entities, or both.
Note: share_percentage across all shareholders (individuals and entities combined) must total exactly 100. The nominal share value of each shareholder is derived automatically as share_percentage / 100 × capital, so it is not part of the request.
individualsarrayrequiredAn array of individual shareholders.
first_namestringrequiredThe first name of the individual shareholder.
Example: Max
middle_namestringThe middle name of the individual shareholder.
Example: Alexander
last_namestringrequiredThe last name of the individual shareholder.
Example: Mustermann
emailstringrequiredThe email address of the individual shareholder.
Example: max.mustermann@example.com
phonestringThe phone number of the individual shareholder.
Required for the first individual shareholder; optional for the others.
Example: +491234567890
dobstringrequiredThe date of birth of the individual shareholder. Format: YYYY-MM-DD.
Example: 1985-05-10
nationalitystringrequiredThe nationality of the individual shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de
addressobjectrequiredThe address of the individual shareholder.
streetstringrequiredThe 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
zipstringrequiredThe postal code of the individual shareholder.
Example: 80336
citystringrequiredThe city of the individual shareholder.
Example: Munich
statestringThe state of the individual shareholder.
Example: Bayern
countrystringrequiredThe country of the individual shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de
share_percentagenumberrequiredThe percentage of shares owned by the shareholder.
Example: 50
is_managing_directorbooleandefault: falseWhether this shareholder is also a managing director of the company. When true, a matching director is created automatically and you do not need to repeat the person in the directors array.
Default value: false
entitiesarrayrequiredAn array of entity shareholders.
namestringrequiredThe name of the entity shareholder.
Example: Max
registration_numberstringrequiredThe registration number of the entity shareholder.
Example: Alexander
addressobjectrequiredThe address of the entity shareholder.
streetstringrequiredThe 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
zipstringrequiredThe postal code of the entity shareholder.
Example: 80336
citystringrequiredThe city of the entity shareholder.
Example: Munich
statestringThe state of the entity shareholder
Example: Bayern
countrystringrequiredThe country of the entity shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de
directorsarrayrequiredThe directors of the entity shareholder.
first_namestringrequiredThe first name of the entity's director.
Example: John
last_namestringrequiredThe last name of the entity's director.
Example: Doe
dobstringrequiredDate of birth of the entity director in YYYY-MM-DD format.
Example: 1978-03-15
nationalitystringrequiredThe nationality of the entity's director, specified using ISO 3166-1 alpha-2 country codes.
Example: de
emailstringrequiredThe email of the entity's director.
Example: john.doe@exemple.com
phonestringThe phone number of the entity director.
Example: +491234567890
addressobjectrequiredAddress of the entity director.
streetstringrequiredThe 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
zipstringrequiredThe postal code of the entity director.
Example: 80336
citystringrequiredThe city of the entity director.
Example: Munich
statestringThe state of the entity director.
Example: Bayern
countrystringrequiredThe country of the entity director, specified using ISO 3166-1 alpha-2 country code.
Example: de
share_percentagenumberrequiredThe percentage of shares owned by the shareholder.
Example: 50
directorsarrayAn array of directors managing the company.
Note: Required unless at least one individual shareholder is flagged with is_managing_director: true, in which case that shareholder becomes the director automatically.
first_namestringrequiredFirst name of the director.
Example: Maria
last_namestringrequiredLast name of the director.
Example: Weber
emailstringrequiredEmail address of the director.
Example: maria.weber@example.com
phonestringThe phone number of the director.
Example: +491234567890
dobstringrequiredDate of birth of the director in YYYY-MM-DD format.
Example: 1978-03-15
nationalitystringrequiredThe nationality of the director, specified using ISO 3166-1 alpha-2 country code.
Example: de
addressobjectrequiredAddress of the director.
streetstringrequiredThe 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
zipstringrequiredThe postal code of the director.
Example: 80336
citystringrequiredThe city of the director.
Example: Munich
statestringThe state of the director.
Example: Bayern
countrystringrequiredThe country of the director, specified using ISO 3166-1 alpha-2 country code.
Example: de
documentsobjectA collection of documents related to the company. Leave empty to have the articles of association generated for you.
articles_of_associationarrayThe articles of association for the company.
typestringrequiredSpecifies the nature of the articles of association. Use musterprotokoll for the standardized template typically used by UGs, or individual for bespoke articles tailored to specific needs, commonly used by GmbHs or UGs with unique requirements.
Possible values: musterprotokoll or individual
urlstringAttach your own articles of association. Only available for an individual document — leave empty to have it generated for you.
Example: https://example.com/gesellschaftsvertrag.pdf
notarizationobjectrequiredDetails about the notarization process.
typestringrequiredThe method of notarization.
Possible values: offline or online
expressbooleandefault: falseRequests expedited notarization.
Default value: false
preferred_timeframenumberThe client's preferred timeframe for notarization, expressed as the number of days from the request date.
Possible values: 7, 14, 30
client_referencestringA custom client reference string for tracking purposes.
Example: REF-2025-001
client_preferred_languagestringdefault: deThe preferred language of the client, specified using ISO 639-1 language codes.
Possible values: en, de, es, fr or it
Default value: de
additional_servicesarrayOptional add-on services the client is interested in alongside the incorporation. Non-binding — used to route follow-up, it does not change the price.
Possible values: authority-registrations, business-liability-insurance, trademark-registration, bookkeeping, tax-advisor-support or business-address
Example: ["authority-registrations", "bookkeeping"]
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
{
"name": "Beglaubigt.de GmbH",
"legal_form": "gmbh",
"purpose": "Durchführung von digitalen Notarisierungsverfahren mit Schwerpunkt auf Deutschland und dem europäischen Raum.",
"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"
},
"capital": 25000,
"shareholders": {
"individuals": [
{
"first_name": "John",
"middle_name": "Michael",
"last_name": "Doe",
"email": "john@doe.de",
"phone": "+49 151 12345678",
"dob": "1985-07-10",
"nationality": "de",
"address": {
"street": "Bahnhofstraße 10",
"street_second_line": "Gebäude B, 2. Etage, Raum 204",
"zip": "10115",
"city": "Berlin",
"state": "Berlin",
"country": "de"
},
"share_percentage": 50
}
],
"entities": [
{
"name": "Acme Holdings GmbH",
"registration_number": "HRB123456",
"address": {
"street": "Königsallee 50",
"street_second_line": "Haus C, 3. Stock, Büro 301",
"zip": "40212",
"city": "Düsseldorf",
"state": "Nordrhein-Westfalen",
"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"
}
},
{
"first_name": "Laura",
"last_name": "Schneider",
"dob": "1990-03-22",
"nationality": "de",
"email": "laura.schneider@example.com",
"phone": "+49 160 12345678",
"address": {
"street": "Lindenweg 7",
"street_second_line": "3. Stock, Wohnung 12",
"zip": "80331",
"city": "München",
"state": "Bayern",
"country": "de"
}
}
],
"share_percentage": 50
}
]
},
"directors": [
{
"first_name": "Maria",
"last_name": "Weber",
"email": "maria@weber.de",
"phone": "+49 151 12345678",
"dob": "1978-03-15",
"nationality": "de",
"address": {
"street": "Schillerstraße 5",
"street_second_line": "2. OG, Einheit 7A",
"zip": "80336",
"city": "Munich",
"state": "Bayern",
"country": "de"
}
}
],
"documents": {
"articles_of_association": [
{
"type": "musterprotokoll"
}
]
},
"notarization": {
"type": "online",
"express": false,
"preferred_timeframe": 7
},
"client_reference": "REF-2025-001",
"client_preferred_language": "de",
"additional_services": ["authority-registrations", "bookkeeping"]
}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.
Example: Incorporation created successfully.
incorporation_idstringThe unique identifier for the created incorporation case in a UUID format.
Example: 450506c1-d1a7-46e2-aca6-41a816805595
statusstringThe current status of the incorporation request.
Possible values: initiated, submitted, contact-with-notary-initiated, appointment-confirmed, appointment-completed, waiting-for-deposit-confirmation, completed, blocked, archive, unprocessable
urlstringA unique, case-specific URL for accessing and monitoring the incorporation process.
Example: https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000
documentsarrayA collection of documents related to the company.
articles_of_associationobjectThe 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 - Beglaubigt.de 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
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
appointment_statusstringThe current status of the notarization appointment.
Possible values: pending or confirmed
client_referencestringThe custom client reference string provided in the request.
Example: REF-2024-001
client_preferred_languagestringThe preferred language of the client, specified using ISO 639-1 language codes.
Possible values: en, de, es, fr or it
timestampstringThe exact date and time when the response was generated, formatted as an ISO 8601 string in UTC.
Example: 2024-12-01T07:19:30.443Z
{
"response": {
"result": "success",
"message": "Incorporation created successfully.",
"incorporation_id": "450506c1-d1a7-46e2-aca6-41a816805595",
"status": "submitted",
"url": "https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000",
"documents": {
"articles_of_association": [
{
"id": "07347a09-7fa2-434f-a5f1-ec897f16d4b9",
"name": "sample.pdf",
"type": "individual",
"status": "submitted"
}
]
},
"notarization": {
"type": "online",
"express": true,
"preferred_timeframe": 7,
"appointment_status": "pending"
},
"client_reference": "REF-2025-001",
"client_preferred_language": "de",
"timestamp": "2025-12-01T07:19:30.443Z"
}
}