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.

POST /v1/incorporation

{
    "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": "Germany"
    },
    "business_address": {
        "street": "Goethestraße 18",
        "street_second_line": "2. Etage, Büro 5B",
        "zip": "50667",
        "city": "Cologne",
        "state": "Nordrhein-Westfalen",
        "country": "Germany"
    },
    "capital": 25000,
    "shareholders": {
        "individuals": [
            {
                "first_name": "John",
                "middle_name": "Michael",
                "last_name": "Doe",
                "email": "[e-mail]",
                "phone": "[phone]",
                "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": "Germany"
                },
                "shares": 12500,
                "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": "[e-mail]",
                        "phone": "[phone]",
                        "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": "[e-mail]",
                        "phone": "[phone]",
                        "address": {
                            "street": "Lindenweg 7",
                            "street_second_line": "3. Stock, Wohnung 12",
                            "zip": "80331",
                            "city": "München",
                            "state": "Bayern",
                            "country": "de"
                        }
                    }
                ],
                "shares": 12500,
                "share_percentage": 50
            }
        ]
    },
    "directors": [
        {
            "first_name": "Maria",
            "last_name": "Weber",
            "email": "[e-mail]",
            "phone": "[phone]",
            "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"
            },
            "authority": "sole"
        }
    ],
    "documents": {
        "articles_of_association": [
            {
                "type": "musterprotokoll",
                "url": "https://pdfobject.com/pdf/sample.pdf"
            }
        ]
    },
    "notarization": {
        "type": "online",
        "express": false,
        "preferred_timeframe": 7
    },
    "client_reference": "REF-2025-001",
    "client_preferred_language": "de"
}

{
    "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": [
                {
                    "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"
    }
}

Authorization

To authenticate requests, include an Authorization header with a Bearer token:

Authorization: Bearer <token>

Example: Bearer sk-123e4567-e89b-12d3-a456-426614174000

Body

name · string · required

The legal name of the company.
Example: Beglaubigt.de GmbH

legal_form · string · required

The type of company being incorporated.
Possible values: gmbh or ug

purpose · string · required

The purpose or business objective of the company.
Example: Digital Notarization Services for Germany and Europe

address · object · required

The address of the company.

Show Address

street · string · required

The street name and number of the company.
Example: Schillerstraße 5

street_second_line · string

Additional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B

zip · string · required

The postal code of the company.
Example: 80336

city · string · required

The city of the company.
Example: Munich

state · string

The state of the company.
Example: Bayern

country · string · required

The country of the company, specified using ISO 3166-1 alpha-2 country code.
Example: de

business_address · object · required

The business address of the company.

Show Business Address

street · string · required

The street name and number of the company.
Example: Schillerstraße 5

street_second_line · string

Additional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B

zip · string · required

The postal code of the company.
Example: 80336

city · string · required

The city of the company.
Example: Munich

state · string

The state of the company.
Example: Bayern

country · string · required

The country of the company, specified using ISO 3166-1 alpha-2 country code.
Example: de

capital · number · required

The total share capital of the company in EUR.
Example: 25000

shareholders · object · required

An object containing arrays of individual and entity shareholders, including their details, addresses, and shareholding information.

Note: At least one shareholder is required.

Show Individuals

individuals · array · required

An array of individual shareholders.

Show Individual

first_name · string · required

The first name of the individual shareholder.
Example: Max

middle_name · string

The middle name of the individual shareholder.
Example: Alexander

last_name · string · required

The last name of the individual shareholder.
Example: Mustermann

email · string · required

The email address of the individual shareholder.
Example: [e-mail]

phone · string

The phone number of the individual shareholder.
Example: [phone]

dob · string · required

The date of birth of the individual shareholder. Format: YYYY-MM-DD.
Example: 1985-05-10

nationality · string · required

The nationality of the individual shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de

address · object · required

The address of the individual shareholder.

Show Address

street · string · required

The street name and number of the individual shareholder.
Example: Schillerstraße 5

street_second_line · string

Additional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B

zip · string · required

The postal code of the individual shareholder.
Example: 80336

city · string · required

The city of the individual shareholder.
Example: Munich

state · string

The state of the individual shareholder.
Example: Bayern

country · string · required

The country of the individual shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de

shares · number · required

The number of shares owned by the shareholder.
Example: 2500

share_percentage · number · required

The percentage of shares owned by the shareholder.
Example: 25

Show Entities

entities · array · required

An array of entity shareholders.

Show Entity

name · string · required

The name of the entity shareholder.
Example: Max

registration_number · string · required

The registration number of the entity shareholder.
Example: Alexander

address · object · required

The address of the entity shareholder.

Show Address

street · string · required

The street name and number of the entity shareholder.
Example: Schillerstraße 5

street_second_line · string

Additional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B

zip · string · required

The postal code of the entity shareholder.
Example: 80336

city · string · required

The city of the entity shareholder.
Example: Munich

state · string

The state of the entity shareholder
Example: Bayern

country · string · required

The country of the entity shareholder, specified using ISO 3166-1 alpha-2 country code.
Example: de

directors · array · required

The directors of the entity shareholder.

Show Directors

first_name · string · required

The first name of the entity’s director.
Example: John

last_name · string · required

The last name of the entity’s director.
Example: Doe

dob · string · required

Date of birth of the entity director in YYYY-MM-DD format.
Example: 1978-03-15

nationality · string · required

The nationality of the entity’s director, specified using ISO 3166-1 alpha-2 country codes.
Example: de

email · string · required

The email of the entity’s director.
Example: [e-mail]

phone · string

The phone number of the entity director.
Example: [phone]

address · object · required

Address of the entity director.

Show Address

street · string · required

The street name and number of the entity director.
Example: Schillerstraße 5

street_second_line · string

Additional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B

zip · string · required

The postal code of the entity director.
Example: 80336

city · string · required

The city of the entity director.
Example: Munich

state · string

The state of the entity director.
Example: Bayern

country · string · required

The country of the entity director, specified using ISO 3166-1 alpha-2 country code.
Example: de

shares · number · required

The number of shares owned by the shareholder.
Example: 2500

share_percentage · number · required

The percentage of shares owned by the shareholder.
Example: 25

directors · array · required

An array of directors managing the company.

Show Director

first_name · string · required

First name of the director.
Example: Maria

last_name · string · required

Last name of the director.
Example: Weber

email · string · required

Email address of the director.
Example: [e-mail]

phone · string

The phone number of the director.
Example: [phone]

dob · string · required

Date of birth of the director in YYYY-MM-DD format.
Example: 1978-03-15

nationality · string · required

The nationality of the director, specified using ISO 3166-1 alpha-2 country code.
Example: de

address · object · required

Address of the director.

Show Address

street · string · required

The street name and number of the director.
Example: Schillerstraße 5

street_second_line · string

Additional address information, such as apartment number, suite, floor, or building.
Example: Apartment 4B

zip · string · required

The postal code of the director.
Example: 80336

city · string · required

The city of the director.
Example: Munich

state · string

The state of the director.
Example: Bayern

country · string · required

The country of the director, specified using ISO 3166-1 alpha-2 country code.
Example: de

authority · string · required

The director’s signing authority.
Possible values: sole or joint

documents · object

A collection of documents related to the company.

Show Documents

articles_of_association · array

The articles of association for the company.

Show Articles of Association

type · string · required

Specifies the nature of the articles of association. Use musterprotokoll for wishing to use standardized template typically used by UGs (Musterprotokoll), or individual for bespoke articles tailored to specific needs, commonly used by GmbHs or UGs with unique requirements. Possible values: musterprotokoll or individual

url · string

If the document already exists, you can attach it. Leave empty if incorporation is done with Musterprotokoll. Example: s3://bucket/gesellschaftervertrag.pdf

notarization · object · required

Details about the notarization process.

Show Notarization

type · string · required

The method of notarization.
Possible values: offline or online

express · boolean · default: "false"

Requests expedited notarization.
Default value: false

preferred_timeframe · number

The client’s preferred timeframe for notarization, expressed as the number of days from the request date. Possible values: 7, 14, 30

client_reference · string

A custom client reference string for tracking purposes.
Example: REF-2025-001

client_preferred_language · string

The preferred language of the client, specified using ISO 639-1 language codes.
Possible values: en, de, es, fr or it

{
    "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": "Germany"
    },
    "business_address": {
        "street": "Goethestraße 18",
        "street_second_line": "2. Etage, Büro 5B",
        "zip": "50667",
        "city": "Cologne",
        "state": "Nordrhein-Westfalen",
        "country": "Germany"
    },
    "capital": 25000,
    "shareholders": {
        "individuals": [
            {
                "first_name": "John",
                "middle_name": "Michael",
                "last_name": "Doe",
                "email": "[e-mail]",
                "phone": "[phone]",
                "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": "Germany"
                },
                "shares": 12500,
                "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": "[e-mail]",
                        "phone": "[phone]",
                        "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": "[e-mail]",
                        "phone": "[phone]",
                        "address": {
                            "street": "Lindenweg 7",
                            "street_second_line": "3. Stock, Wohnung 12",
                            "zip": "80331",
                            "city": "München",
                            "state": "Bayern",
                            "country": "de"
                        }
                    }
                ],
                "shares": 12500,
                "share_percentage": 50
            }
        ]
    },
    "directors": [
        {
            "first_name": "Maria",
            "last_name": "Weber",
            "email": "[e-mail]",
            "phone": "[phone]",
            "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"
            },
            "authority": "sole"
        }
    ],
    "documents": {
        "articles_of_association": [
            {
                "type": "musterprotokoll",
                "url": "https://pdfobject.com/pdf/sample.pdf"
            }
        ]
    },
    "notarization": {
        "type": "online",
        "express": false,
        "preferred_timeframe": 7
    },
    "client_reference": "REF-2025-001",
    "client_preferred_language": "de"
}

Response

result · string

Indicates the outcome of the API request.
Possible values: success or error

message · string

Provides a human-readable message detailing the result of the API request.
Example: Incorporation created successfully.

incorporation_id · string

The unique identifier for the created incorporation case in a UUID format.
Example: 450506c1-d1a7-46e2-aca6-41a816805595

status · string

The 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

url · string

A 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

documents · array

A collection of documents related to the company.

Show Documents

articles_of_association · object

The articles of association for the company.

Show Article of Association

id · string

The unique identifier for the document in a UUID format.
Example: 07347a09-7fa2-434f-a5f1-ec897f16d4b9

type · string

The type of document as specified in the request.
Possible values: musterprotokoll , individual, gesellschafterliste, certificate-of-incorporation or deposit-confirmation

status · string

Indicates the current processing state of the document.
Possible values: submitted, in-review or reviewed

notarization · object

Details about the notarization process.

Show Notarization

type · string

The method of notarization.
Possible values: offline or online

express · boolean

Requests expedited notarization.

preferred_timeframe · number

The client’s preferred timeframe for notarization, expressed as the number of days from the request date. Possible values: 7, 14, 30

appointment_status · string

The current status of the notarization appointment. Possible values: pending or confirmed

client_reference · string

The custom client reference string provided in the request.
Example: REF-2024-001

client_preferred_language · string

The preferred language of the client, specified using ISO 639-1 language codes.
Possible values: en, de, es, fr or it

timestamp · string

The 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": [
                {
                    "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"
    }
}