Notary
List 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.
get/public/v2/notary/notarization-requests
Query parameters
statusstring[]
Filter by status (comma-separated values supported).
created_by_user_idstring[]
Filter by creator user ID (comma-separated values supported).
document_idstring[]
Filter by document ID (comma-separated values supported).
offsetinteger
Number of results to skip.
limitinteger
Maximum number of results to return.
order_by'status' | '-status' | 'date_created' | '-date_created' | 'date_completed' | '-date_completed'
Sort field. Use a - prefix for descending order (e.g., -date_created). When omitted, results are sorted by date_created ascending (oldest first).
Response
Paginated list of notarization requests
Example response
{
"results": [
{
"id": "0b2256a2-5803-4ae9-b1b8-595f48e37173",
"status": "SENT",
"name": "Sample Notarization Request",
"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"
}
],
"count": 2
}