Create Notarization Request

post https://api.pandadoc.com/public/v2/notary/notarization-requests

Use this endpoint to connect with a notary, ready to complete online notarizations for your signers within minutes.

Before you start

Ensure the following before creating a notarization request:

Install the Notary On-Demand add-on.
Create a document for notarization and get its document_id. To create a document, use the Create Document from Template or Create Document from File Upload endpoint.

For the notarization request, include in the request body:

document_id
At least one invitees, specifying their email, first_name, and last_name.
Optionally, include a message for your signers.
Optionally, using disable_invitees_notifications you can disable all notifications for invitees including email with invitation for notarization. This is useful when you are using alternative delivery methods.

After the API call is executed, your signers will receive an email invitation for notarization. Alternatively, you can directly share the notarization_link with your signers, which is available in the 201 response body.

Upon successful notarization, you will receive an email with a link to the notarized document.

Tips

Ensure that signers are added as both invitees in the request body and recipients in the document to avoid inconveniences during notary sessions.
Signers will receive an email with a notary link upon a successful API call; this link is also in the 201 response.
Use the link to connect with commissioned online notaries, available Mon-Fri, 9 AM - 9 PM Central Time, typically responding within 2 minutes.

Limits

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

Solutions for 4xx Response Codes

403 Forbidden (Inactive Add-on): Ensure the Notary On-Demand add-on is installed.
403 Forbidden (Transactions Limit): Purchase additional transactions either through the Notary UI or by contacting the Sales team.
429 Too Many Requests: If you hit the limit, hold your API calls, then send them after waiting for the retry time.

To learn more about PandaDoc Notary On-Demand, visit our website.

time	status	user agent
Retrieving recent requests…

Loading…

Responses

Response body

object

string

A unique identifier of the notarization request.

name

string

A name of the notarization request.

status

string

Current status of the notarization request.

DRAFT SENT WAITING_FOR_NOTARY ACCEPTED LIVE COMPLETED TERMINATED CANCELLED

date_created

date-time

A date when a notarization request was created.

date_accepted

date-time | null

A date when a notarization session was accepted by notary.

created_by

object

user_id

string

A unique identifier of the user who created a notarization request.

string

A user's email address.

first_name

string

A user's first name.

last_name

string

A user's last name.

invitees

array of objects

invitees

object

string

A unique identifier of the invitee.

string

length ≤ 255

A invitee's email address.

first_name

string

length ≤ 50

A invitee's first name.

last_name

string

length ≤ 50

A invitee's last name.

notarization_link

string

A secure link to join a notarization request.

Language

Credentials


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.pandadoc.com/public/v2/notary/notarization-requests \
3
     --header 'Authorization: API-Key 3039ba033eb1410caa0a2227158d63c9d6502cd8' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json'


xxxxxxxxxx
21
 
1
{
2
  "id": "f75e053a-25e8-40be-8681-fd755ade2a2b",
3
  "name": "test",
4
  "status": "SENT",
5
  "date_created": "2023-04-14T16:33:06.938984Z",
6
  "date_accepted": null,
7
  "created_by": {
8
    "first_name": "test",
9
    "last_name": "test",
10
    "email": "user@example.com",
11
    "id": "nyAnVpY7pZ23FBve8s9xgk"
12
  },
13
  "invitees": [
14
    {
15
      "first_name": "test",
16
      "last_name": "test",
17
      "email": "signer@example.com",
18
      "notarization_link": "https://notarize.pandadoc.com/session-request#/?requestId=f75e053a-25e8-40be-8681-fd755ade2a2b&inviteeId=2fbb4cbf-d461-4421-94cf-eaadcb9627e0"
19
    }
20
  ]
21
}

201Notarization request has been created successfully

403Permission error

429Too Many Requests