Get Incorporation

This endpoint retrieves the details of an incorporation

GET /v1/incorporation/{incorporation_id}

Get Incorporation

cURL

curl --request GET \
  --url https://api.beglaubigt.de/v1/incorporation/{incorporation_id}

{
    "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.",
        "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": "submitted",
        "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": "musterprotokoll",
                    "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"
    }
}

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_id · string · required

The unique identifier of the incorporation to retrieve.
Example: 123e4567-e89b-12d3-a456-426614174000

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.
Exemple: Incorporation fetched successfully.

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: Acme Holdings GmbH

legal_form · string

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

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

hrb_number · string

The commercial register number (Handelsregisternummer) for incorporations.
Example: HRB 123456

court_district · string

The local court (Amtsgericht) where the company is registered.
Example: Berlin (Charlottenburg)

is_registered · boolean

Indicates whether the company is already officially entered in the commercial register.
Example: true

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. Possible values: initiated, submitted, contact-with-notary-initiated, appointment-confirmed, appointment-completed, waiting-for-deposit-confirmation, completed, blocked, archive, unprocessable

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

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, specified using ISO 3166-1 alpha-2 country code.
Example: de

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

street · string

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

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

created_at · string

The 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.",
        "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": "submitted",
        "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": "musterprotokoll",
                    "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"
    }
}