---
title: "List Notarization Requests"
method: GET
path: "/public/v2/notary/notarization-requests"
tags: ["Notary"]
---

# List Notarization Requests

`GET /public/v2/notary/notarization-requests`

Retrieve a paginated list of notarization requests for your organization.

Results can be filtered by status, creator, or document, and sorted by status or by the request's creation or completion dates.

## Permissions

> 🔒 **Requirements**
>
> - The **Notary On-Demand** or **Notary** add-on must be enabled for your organization. Without an active add-on, the endpoint returns `403 Forbidden`.
> - The request is executed with the permissions of the API key owner. By default, the response only includes notarization requests created by the API key owner. To list notarization requests created by any user in the organization, the API key owner must have the **Can view any notarization request** permission.

## Limits

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

## Query parameters

- `status` string[]
- `created_by_user_id` string[]
- `document_id` string[]
- `offset` integer
- `limit` integer
- `order_by` 'status' | '-status' | 'date_created' | '-date_created' | 'date_completed' | '-date_completed'

## Response `200`

Paginated list of notarization requests

- ListNotarizationRequestsResponse
  - `results` object[] — Array of notarization request objects.
    - `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.
    - `name` string — Name 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_user_id` string — Public user id of the request creator.
  - `count` integer — Total number of notarization requests matching the criteria.

## Other responses

- `400` — Bad Request error
- `401` — Authentication error
- `403` — Permission error
- `429` — Too many requests error

---

[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/revisions/0c2b70be3fb0/schema)