---
title: "Notarization Request Details"
method: GET
path: "/public/v2/notary/notarization-requests/{session_request_id}"
tags: ["Notary"]
---

# Notarization Request Details

`GET /public/v2/notary/notarization-requests/{session_request_id}`

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 Status | Status Description                                                                                                 |
| :-------------------------- | :----------------------------------------------------------------------------------------------------------------- |
| SENT                        | Notarization request has been created. Invitees are notified and can start the process of finding a notary.        |
| WAITING_FOR_NOTARY          | One of the invitees initialised the process of finding a notary.                                                   |
| ACCEPTED                    | Notarization request has been accepted by the notary. At this time nobody has joined the notarization session yet. |
| LIVE                        | Notarization session has started.                                                                                  |
| COMPLETED                   | Notarization session is finished. Documents have been successfully signed and ready for downloading.               |
| INCOMPLETE                  | Notarization 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.

## Path parameters

- `session_request_id` string, uuid, required

## Response `200`

Details about notarization request

- NotarizationRequestDetailsResponse
  - `id` string — 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_id` string — A unique identifier of the document for notarization.
  - `date_created` string, date-time — A date when a notarization request was created.
  - `date_started` string, date-time, nullable — A date when a notarization session was started.
  - `date_completed` string, date-time, nullable — A date when a notarization session was completed.
  - `created_by` object
    - `user_id` string — A unique identifier of the user who created a notarization request.
    - `email` string — A user's email address.
    - `first_name` string — A user's first name.
    - `last_name` string — A user's last name.
  - `invitees` object[]
    - `id` string — A unique identifier of the invitee.
    - `email` string, email — A invitee's email address.
    - `first_name` string, nullable — A invitee's first name.
    - `last_name` string, nullable — A invitee's last name.
  - `signed_documents` object[]
    - `url` string — Secure URL to download signed PDF document.
    - `document_name` string — A signer document name.
    - `size` number — A signer document size in bytes.
    - `document_type` 'COMBINED' | 'SINGLE' — A type of the signed document.
  - `recording` object, nullable
    - `url` string — Secure URL to download video recording of the notarization session.
    - `name` string — Name of the video recording file.
    - `size` number — Size of the video recording file in bytes.
  - `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_details` string, nullable — Additional details about the termination reason provided by the notary. Only present when the request status is INCOMPLETE.

---

[API](https://skmtc.net/pandadoc/apis/pandadoc-public-api.md) · [All operations](https://skmtc.net/pandadoc/apis/pandadoc-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandadoc/pandadoc-public-api/versions/0c2b70be3fb0/schema)