Create Notarization
This endpoint creates a notarization request for a document
Authorization
To authenticate requests, include an Authorization header with a Bearer token:
Authorization: Bearer <token>
Example: Bearer sk-123e4567-e89b-12d3-a456-426614174000
Body
jurisdictionstringrequiredThe jurisdiction in which the notarization will be executed.
Example: US
statestringThe state or region within the jurisdiction.
Example: CA
documentsarrayrequiredAn array of documents to be notarized containing document details and signer information.
document_typestringThe type of document.
Example: Power of Attorney
document_fileobjectrequiredFile details for the document.
typestringrequiredType of file reference.
Note: Must be url
urlstringrequiredURL to the document file
require_signaturesbooleandefault: falseWhether the document requires signatures before notarization.
autodetectionbooleandefault: falseSignature and location/date fields will be automatically identified across the entire document using AI-powered detection.
Note: This feature is in beta.
signersarrayrequiredArray of signers for this document.
emailstringrequiredEmail address of the signer.
first_namestringrequiredFirst name of the signer.
last_namestringrequiredLast name of the signer.
middle_namestringMiddle name of the signer.
dobstringDate of birth of the signer in YYYY-MM-DD format.
phonestringPhone number of the signer.
labelsarrayLabel information for signature positioning or other metadata.
typestringrequiredType 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.
pagenumberrequiredPage number for the label placement.
Note: Required if autodetection is disabled.
x_positionnumberrequiredX coordinate for label placement.
Note: Required if autodetection is disabled.
y_positionnumberrequiredY coordinate for label placement.
Note: Required if autodetection is disabled.
widthnumberrequiredWidth of the label area.
Note: Required if autodetection is disabled.
heightnumberrequiredHeight of the label area.
Note: Required if autodetection is disabled.
autodetectionbooleandefault: falseThe 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_environmentstringdefault: productionSpecifies the environment for the KYC API.
Possible values: sandbox, production
client_referencestringA custom client reference string for tracking purposes.
Example: REF-2024-001
client_preferred_languagestringdefault: enThis determines the language in which emails will be sent to the client.
Possible values: en, de, es, fr or it
Response
resultstringIndicates the outcome of the API request.
Possible values: success or error
messagestringProvides a human-readable message detailing the result of the API request.
Exemple: Case created successfully.
case_idstringThe unique identifier for the created case in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
statusstringThe current status of the notarization request.
Possible values: in-progress or completed
urlstringA 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
documentsarrayList of documents included in this notarization request.
idstringThe unique identifier for the created notarization case in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
typestringThe type of document as specified in the request.
statusstringIndicates the current processing state of the specific document within the notarization case.
Possible values: draft, signatures-requested, waiting-for-verifications, notarization-started or completed
signersarrayList of signers included in this notarization request.
first_namestringThe first name of the signer as provided during the notarization process.
last_namestringThe last name of the signer as provided during the notarization process.
emailstringThe email address of the signer as provided during the notarization process.
urlstringA 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
timestampstringThe 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": "john@example.com",
"first_name": "John",
"middle_name": "Andreas",
"last_name": "Doe",
"dob": "1985-07-10",
"phone": "+49123456789",
"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": "john@example.com",
"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"
}
}