Beglaubigt.de API
Events

Incorporation Blocked

Understanding the Event

The incorporation.blocked event is automatically triggered when an incorporation data has been verified and blocked 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: blocked

messagestring

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

incorporation_idstring

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

statusstring

The status of the incorporation.
Value: blocked

reasonstring

The reason provided by our team for blocking the incorporation.
Example: The shareholder's identity document is invalid.

urlstring

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

client_referencestring

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

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": "123e4567-e89b-12d3-a456-426614174000",
  "event": "incorporation.blocked",
  "message": "The incorporation has been blocked.",
  "incorporation_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "blocked",
  "reason": "The shareholder's identity document is invalid.",
  "url": "https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000",
  "client_reference": "REF-2025-001",
  "timestamp": "2025-10-18T12:00:00Z"
}

On this page