Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-24122271451.2 KB
Notary

Notarization Request Details

Get details about a notarization request by its id.

Details include:

  • Basic notarization request information (status, creator, invitees).
  • Signed documents information with links for downloading.
  • Notarization session recording information with link for downloading.
  • Timestamps associated with a notarization request.
  • Termination reason and details when the notarization session was not completed successfully.

Available Notarization Request Statuses

The following is a complete list of all possible notarization request statuses returned:

Notarization Request StatusStatus Description
SENTNotarization request has been created. Invitees are notified and can start the process of finding a notary.
WAITING_FOR_NOTARYOne of the invitees initialised the process of finding a notary.
ACCEPTEDNotarization request has been accepted by the notary. At this time nobody has joined the notarization session yet.
LIVENotarization session has started.
COMPLETEDNotarization session is finished. Documents have been successfully signed and ready for downloading.
INCOMPLETENotarization session has started but was not completed successfully.

Signed documents

Signed documents are the documents that were successfully signed during the notarization session. The signed document's info is available only if the notarization request has COMPLETED status, otherwise the returned list will be empty.

In case you uploaded several documents for notarization then the signed_documents list will contain links for downloading for each document separately (with SINGLE document type) and link for the combined document (with COMBINED document type accordingly).

Recording

Recording is the video of the notarization session. The recording info is available only if the notarization request has COMPLETED status and recording is available, otherwise the returned object will be empty.

📘 Links expire in 1 hour

Note: The signed document and recording links expire in 1 hour. After this time it will be not possible to download files using the returned urls. In this case you need to call endpoint again since each request generates a new link.

Limits

A maximum of 100 API calls per minute is permitted. Exceeding this limit triggers a 429 Too Many Requests error.

get/public/v2/notary/notarization-requests/{session_request_id}

Path parameters

session_request_idstring uuid required

Notarization Request ID.

Response

Details about notarization request

idstring

A unique identifier of the notarization request.

status'DRAFT' | 'SENT' | 'WAITING_FOR_NOTARY' | 'ACCEPTED' | 'LIVE' | 'COMPLETED' | 'INCOMPLETE' | 'CANCELLED'

Current status of the notarization request.

document_idstring

A unique identifier of the document for notarization.

date_createdstring date-time

A date when a notarization request was created.

date_startedstring date-time nullable

A date when a notarization session was started.

date_completedstring date-time nullable

A date when a notarization session was completed.

termination_reason'SIGNER_NO_SHOW' | 'AUDIO_VIDEO_ISSUE' | 'FAILED_IDENTITY_VERIFICATION' | 'TEST_SESSION' | 'OTHER' nullable

The reason why the notarization session was terminated. Only present when the request status is INCOMPLETE.

termination_detailsstring nullable

Additional details about the termination reason provided by the notary. Only present when the request status is INCOMPLETE.

Example response

{
  "id": "0b2256a2-5803-4ae9-b1b8-595f48e37173",
  "status": "SENT",
  "document_id": "D3okRfgHRX7NEhavcACReB",
  "date_created": "2025-01-13T10:25:53.800367Z",
  "date_started": "2025-01-13T10:25:53.800367Z",
  "date_completed": "2025-01-13T10:25:53.800367Z",
  "created_by": {
    "user_id": "nyAnVpY7pZ23FBve8s9xgk",
    "email": "josh@example.com",
    "first_name": "Josh",
    "last_name": "Ron"
  },
  "invitees": [
    {
      "id": "nyAnVpY7pZ23FBve8s9xgk",
      "email": "josh@example.com",
      "first_name": "Josh",
      "last_name": "Ron"
    }
  ],
  "signed_documents": [
    {
      "document_name": "example.pdf",
      "size": 523107,
      "document_type": "SINGLE"
    }
  ],
  "recording": {
    "size": 5242880
  },
  "termination_reason": "FAILED_IDENTITY_VERIFICATION",
  "termination_details": "The signer failed to verify their identity."
}