Incorporation Completed

Understanding the Event

The incorporation.completed event is triggered automatically when an incorporation data has been verified and confirmed by our internal team.

Payload Fields

webhook_id · string

A unique identifier for this webhook in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000

event · string

The name of the event that triggered this webhook.
Value: incorporation.completed

message · string

Provides a human-readable message indicating the result of the webhook event.
Value: The incorporation has been completed.

incorporation_id · string

The unique identifier for the incorporation in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000

name · string

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

purpose · string

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

capital · number

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

address · object

The address of the company.

Show Address

street · string

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

The postal code of the company.
Example: 80336

city · string

The city of the company.
Example: Munich

state · string

The state of the company.
Example: Bayern

country · string

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

business_address · object

The business address of the company.

Show Business Address

street · string

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

The postal code of the company.
Example: 80336

city · string

The city of the company.
Example: Munich

state · string

The state of the company.
Example: Bayern

country · string

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

status · string

The status of the incorporation.
Values: completed

url · string

The URL of the incorporation.
Example: https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000

directors · array

An array of directors managing the company.

Show Director

first_name · string

First name of the director.
Example: Maria

last_name · string

Last name of the director.
Example: Weber

email · string

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

phone · string

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

dob · string

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

nationality · string

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

address · object

Address of the director.

Show Address

street · string

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

The postal code of the director.
Example: 80336

city · string

The city of the director.
Example: Munich

state · string

The state of the director
Example: Bayern

country · string

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

authority · string

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 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

shareholders · object

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

Show Shareholders

Show Individuals

individuals · array

An array of individual shareholders.

Show Individual

first_name · string

The first name of the individual shareholder.
Example: Max

middle_name · string

The middle name of the individual shareholder.
Example: Alexander

last_name · string

The last name of the individual shareholder.
Example: Mustermann

email · string

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

phone · string

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

dob · string

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

nationality · string

The nationality of the individual shareholder.
Example: German

address · object

The address of the individual shareholder.

Show Address

street · string

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

The postal code of the individual shareholder.
Example: 80336

city · string

The city of the individual shareholder.
Example: Munich

state · string

The state of the individual shareholder.
Example: Bayern

country · string

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

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

Show Entities

entities · array

An array of entity shareholders.

Show Entity

name · string

The name of the entity shareholder.
Example: Max

registration_number · string

The registration number of the entity shareholder.
Example: Alexander

address · object

The address of the entity shareholder.

Show Address

street · string

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

The postal code of the entity shareholder.
Example: 80336

city · string

The city of the entity shareholder.
Example: Munich

state · string

The state of the entity shreholder.
Example: Bayern

country · string

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

directors · array

The directors of the entity shareholder.

Show Directors

first_name · string

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

last_name · string

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

dob · string

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

nationality · string

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

email · string

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

phone · string

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

address · object

Address of the entity director.

Show Address

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

The postal code of the entity director.
Example: 80336

city · string

The city of the entity director.
Example: Munich

state · string

The state of the entity director.
Example: Bayern

country · string

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

shares · number

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

share_percentage · number

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

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

date · string

Notarization date in YYYY-MM-DD format.
Example: 2025-04-16

time · string

Notarization date in HH:mm format.
Example: 14:30

appointment_status · string

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

notary · object

Notary responsible for the notarization.

Show Notary

office · string

The name of the notary’s office.
Example: Notariat Schiller & Partner

name · string

The full name of the notary.
Example: Dr. Anna Becker

email · string

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

phone · string

The contact phone number of the notary.
Example: [phone]

address · string

The full address of the notary’s office, formatted as street name and number, postal code, city.
Example: Schillerstraße 15, 10117, Berlin

client_reference · string

Your custom reference string provided during incorporation creation.
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

timestamp · string

The exact date and time when the webhook was triggered, formatted as an ISO 8601 string in UTC.
Example: 2025-06-01T08:00:00.443Z

{
    "webhook_id": "bbcc7dfd-e501-4c7e-a94c-296af04044e2",
    "event": "incorporation.completed",
    "message": "The incorporation has been completed.",
    "incorporation_id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Acme Holdings GmbH",
    "type": "gmbh",
    "purpose": "Durchführung von digitalen Notarisierungsverfahren mit Schwerpunkt auf Deutschland und dem europäischen Raum.",
    "capital": 12500,
    "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": "completed",
    "url": "https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000",
    "directors": [
        {
            "first_name": "Maria",
            "last_name": "Weber",
            "email": "[e-mail]",
            "phone": "[phone]",
            "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": [
            {
                "name": "sample.pdf",
                "type": "individual",
                "status": "submitted"
            }
        ]
    },
    "shareholders": {
        "individuals": [
            {
                "first_name": "John",
                "middle_name": "Michael",
                "last_name": "Doe",
                "email": "[e-mail]",
                "phone": "[phone]",
                "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": "[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"
                        }
                    }
                ],
                "shares": 5000,
                "share_percentage": 5
            }
        ]
    },
    "notarization": {
        "type": "online",
        "express": false,
        "preferred_timeframe": 7,
        "date": "2025-05-16",
        "time": "14:30",
        "appointment_status": "confirmed",
        "notary": {
            "office": "Notariat Schiller & Partner",
            "name": "Dr. Anna Becker",
            "email": "[e-mail]",
            "phone": "[phone]",
            "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"
}