Beglaubigt.de API
Events

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_idstring

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

eventstring

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

messagestring

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

incorporation_idstring

The unique identifier for the incorporation in a UUID format.
Example123e4567-e89b-12d3-a456-426614174000

namestring

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

purposestring

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

capitalnumber

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

addressobject

The address of the company.

business_addressobject

The business address of the company.

statusstring

The status of the incorporation.
Values: completed

urlstring

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

directorsarray

An array of directors managing the company.

documentsobject

A collection of documents related to the company.

shareholdersobject

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

notarizationobject

Details about the notarization process.

client_referencestring

Your custom reference string provided during incorporation creation.
Example: REF-2025-001

client_preferred_languagestring

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

timestampstring

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

Response
{
    "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": "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": [
            {
                "name": "sample.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": 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": "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"
}

On this page