---
title: "List Notaries"
method: GET
path: "/public/v2/notary/notaries"
tags: ["Notary"]
---

# List Notaries

`GET /public/v2/notary/notaries`

## Request

- Base URL: `https://api.pandadoc.com`
- URL: `https://api.pandadoc.com/public/v2/notary/notaries`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.pandadoc.com/oauth2/authorize`
    - Token URL: `https://api.pandadoc.com/oauth2/access_token`
- TypeScript: <https://skmtc.dev/pandadoc/apis/pandadoc-public-api/docs/public/v2/notary/notaries/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of notaries associated with your organization.

## Important Notes

- At the moment, notaries can be added to organization only manually through the PandaDoc Notary UI. 
- Organization must have Notary addon enabled to use this endpoint

## Query parameters

- `status` string[]
- `commission_state` string[]
- `offset` integer
- `limit` integer
- `order_by` 'email' | '-email' | 'status' | '-status' | 'name' | '-name'

## Response `200`

List of notaries retrieved successfully

- ListNotariesResponse
  - `results` object[]: Array of notary objects
    - `id` string: Unique identifier for the notary
    - `email` string, email: Email address of the notary
    - `name` string, nullable: Full name of the notary
    - `status` 'INVITED' | 'UNDER_REVIEW' | 'ACTIVE' | 'REJECTED' | 'INACTIVE': Current status of the notary
    - `commission_state` string, nullable
  - `count` integer: Total number of notaries matching the criteria

## Other responses

- `400`: Bad Request error
- `403`: Permission error
- `429`: Too many requests error

---

[API](https://skmtc.dev/pandadoc/apis/pandadoc-public-api.md) - [All operations](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/revisions/b9a306b1a421?raw)