Create Notarization

This endpoint creates a notarization request for a document

POST /v1/notarization

{
  "jurisdiction": "US",
  "state": "CA",
  "documents": [
      {
          "document_type": "Power of Attorney",
          "document_file": {
              "type": "url",
              "url": "https://app.beglaubigt.de/Power-of-Attorney.pdf"
          },
          "require_signatures": true,
          "autodetection": false,
          "signers": [
              {
                  "email": "[e-mail]",
                  "first_name": "John",
                  "middle_name": "Andreas",
                  "last_name": "Doe",
                  "dob": "1985-07-10",
                  "phone": "[phone]",
                  "labels": [
                      {
                          "type": "signature",
                          "autodetection": true
                      },
                      {
                          "type": "location-and-date",
                          "page": 3,
                          "x_position": 396,
                          "y_position": 553,
                          "width": 270,
                          "height": 54,
                          "autodetection": false
                      }
                  ]
              }
          ]
      }
  ],
  "persona_environment": "production",
  "client_reference": "REF-2024-001",
  "client_preferred_language": "de"
}

{
  "response": {
      "result": "success",
      "message": "Case created successfully.",
      "case_id": "450506c1-d1a7-46e2-aca6-41a816805595",
      "status": "in-progress",
      "url": "https://app.beglaubigt.de/notarize/450506c1-d1a7-46e2-aca6-41a816805595",
      "documents": [
          {
              "id": "07347a09-7fa2-434f-a5f1-ec897f16d4b9",
              "type": "Power of Attorney",
              "status": "signatures-requested"
          }
      ],
      "signers": [
          {
              "first_name": "John",
              "last_name": "Doe",
              "email": "[e-mail]",
              "url": "https://app.beglaubigt.de/notarize/450506c1-d1a7-46e2-aca6-41a816805595?token=8963cd77-b5f9-4280-986d-6137e9fea106"
          }
      ],
      "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

jurisdiction · string · required

The jurisdiction in which the notarization will be executed.
Example: US

state · string

The state or region within the jurisdiction.
Example: CA

documents · array · required

An array of documents to be notarized containing document details and signer information.

Show Document Object

document_type · string

The type of document.
Example: Power of Attorney

document_file · object · required

File details for the document.

type · string · required

Type of file reference.
Note: Must be url

url · string · required

URL to the document file

require_signatures · boolean · default: "false"

Whether the document requires signatures before notarization.

autodetection · boolean · default: "false"

Signature and location/date fields will be automatically identified across the entire document using AI-powered detection.

Note: This feature is in beta.

signers · array · required

Array of signers for this document.

Show Signer Object

email · string · required

Email address of the signer.

first_name · string · required

First name of the signer.

last_name · string · required

Last name of the signer.

middle_name · string

Middle name of the signer.

dob · string

Date of birth of the signer in YYYY-MM-DD format.

phone · string

Phone number of the signer.

labels · array

Label information for signature positioning or other metadata.

Show Label Object

type · string · required

Type of label: signature or location-and-date

signature : Prompts the user to sign and displays their signature.

location-and-date : Detects the signer’s location and records the date upon signature.

page · number · required

Page number for the label placement.

Note: Required if autodetection is disabled.

x_position · number · required

X coordinate for label placement.

Note: Required if autodetection is disabled.

y_position · number · required

Y coordinate for label placement.

Note: Required if autodetection is disabled.

width · number · required

Width of the label area.

Note: Required if autodetection is disabled.

height · number · required

Height of the label area.

Note: Required if autodetection is disabled.

autodetection · boolean · default: "false"

The label field will be automatically identified using AI-powered detection. You can specify the page to improve accuracy.

Note: This feature is in beta.

kyc_environment · string · default: "production"

Specifies the environment for the KYC API.
Possible values: sandbox, production

client_reference · string

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

client_preferred_language · string · default: "en"

This determines the language in which emails will be sent to the client.
Possible values: en, de, es, fr or it

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: Case created successfully.

case_id · string

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

status · string

The current status of the notarization request.
Possible values: in-progress or completed

url · string

A unique, case-specific URL for accessing and monitoring the current status and details of the notarization process.
Example: https://app.platus.com/notarize/123e4567-e89b-12d3-a456-426614174000

documents · array

List of documents included in this notarization request.

Show Documents Response Object

id · string

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

type · string

The type of document as specified in the request.

status · string

Indicates the current processing state of the specific document within the notarization case.
Possible values: draft, signatures-requested, waiting-for-verifications, notarization-started or completed

signers · array

List of signers included in this notarization request.

Show Signers Response Object

first_name · string

The first name of the signer as provided during the notarization process.

last_name · string

The last name of the signer as provided during the notarization process.

email · string

The email address of the signer as provided during the notarization process.

url · string

A unique invitation link containing an identification token. The link prompts the signer to complete the required actions, such as signing or verifying documents, based on the notarization requirements.
Example: https://app.beglaubigt.de/notarize/123e4567-e89b-12d3-a456-426614174000?token=123e4567-e89b-12d3-a456-426614174001

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

{
  "jurisdiction": "US",
  "state": "CA",
  "documents": [
      {
          "document_type": "Power of Attorney",
          "document_file": {
              "type": "url",
              "url": "https://app.beglaubigt.de/Power-of-Attorney.pdf"
          },
          "require_signatures": true,
          "autodetection": false,
          "signers": [
              {
                  "email": "[e-mail]",
                  "first_name": "John",
                  "middle_name": "Andreas",
                  "last_name": "Doe",
                  "dob": "1985-07-10",
                  "phone": "[phone]",
                  "labels": [
                      {
                          "type": "signature",
                          "autodetection": true
                      },
                      {
                          "type": "location-and-date",
                          "page": 3,
                          "x_position": 396,
                          "y_position": 553,
                          "width": 270,
                          "height": 54,
                          "autodetection": false
                      }
                  ]
              }
          ]
      }
  ],
  "persona_environment": "production",
  "client_reference": "REF-2024-001",
  "client_preferred_language": "de"
}

{
  "response": {
      "result": "success",
      "message": "Case created successfully.",
      "case_id": "450506c1-d1a7-46e2-aca6-41a816805595",
      "status": "in-progress",
      "url": "https://app.beglaubigt.de/notarize/450506c1-d1a7-46e2-aca6-41a816805595",
      "documents": [
          {
              "id": "07347a09-7fa2-434f-a5f1-ec897f16d4b9",
              "type": "Power of Attorney",
              "status": "signatures-requested"
          }
      ],
      "signers": [
          {
              "first_name": "John",
              "last_name": "Doe",
              "email": "[e-mail]",
              "url": "https://app.beglaubigt.de/notarize/450506c1-d1a7-46e2-aca6-41a816805595?token=8963cd77-b5f9-4280-986d-6137e9fea106"
          }
      ],
      "client_reference": "REF-2025-001",
      "client_preferred_language": "de",
      "timestamp": "2025-12-01T07:19:30.443Z"
  }
}