Pigeon
  1. Requests
Pigeon
  • Introduction
  • Authentication
  • Integrations
  • Webhooks
  • Guides
    • How To Share Files via Pigeon
    • How To Create an E-Signature Request Item
    • How To Send Emails from Organization Addresses
  • Requests
    • Create Request
      POST
    • List Requests
      GET
    • Get Request
      GET
    • Delete Request
      DELETE
    • Update Request
      PATCH
    • Verify Request
      POST
    • Close Request
      POST
    • Duplicate Request
      POST
    • Reject Request (Request Changes)
      POST
    • Send Request Reminder
      POST
    • List Request Reminders
      GET
    • Get Request Activity Log
      GET
    • List Organization Requests
      GET
    • Update Request
      PATCH
    • Delete Request
      DELETE
  • Request Items
    • List Request Items
      GET
    • Get Request Item
      GET
    • Verify Request Item
      POST
    • Update Request Item
      PATCH
    • Delete Request Item
      DELETE
    • Create Request Item
      POST
  • Templates
    • Create Template
    • List Templates
    • Get Template
    • Delete Template
    • Update Template
    • List Organization Templates
  • Webhooks
    • Create Webhook Subscription
    • Get Webhook Subscription
    • List Webhook Subscriptions
    • Update Webhook Subscription
    • Delete Webhook Subscription
  • Files
    • Download Request Files
    • Download Request Item Files
    • Download File
    • Get Request Files
    • Get Request Item Files
    • Delete File
  • Request Attachments
    • Upload Attachment
    • List Item Attachments
    • Get Attachment
    • Download Attachment
    • Delete Attachment
  • File Sharing
    • Initialize File Sharing Session
    • Upload File
    • Share Files
    • List File Sharing Sessions
    • Get File Sharing Session
    • Update File Sharing Session
    • Delete File Sharing Session
  • E-Signature / Document Forms
    • Create New E-Signature Document
    • Update E-Signature Document
    • Get E-Signature Document
    • List E-Signature Documents
    • Delete E-Signature Document
  • Users
    • List Users
    • Get User
    • Get Current User
  • Cloud Storage
    • List Cloud Storage Providers
    • Connect Cloud Storage Providers
    • Disconnect Cloud Storage Provider
  • Branding
    • Get Organization Branding
    • Update Organization Branding
  • Confirmation Page
    • Enable/Disable Signature Confirmation Page
  • Organization
    • Get Organization Settings
    • Update Organization Settings
  • RequestItems
    • Create Request Item
    • List Request Items
    • Get Request Item
    • Update Request Item
    • Delete Request Item
    • Verify Request Item
  • Documents
    • Get Document
    • Delete Document
    • List Request Documents
    • Delete Request Documents
    • List Request Item Documents
    • Download Document
    • Download Request Documents
    • Download Request Item Documents
  1. Requests

Verify Request

POST
/requests/{id}/verify
Marks a request as verified, which indicates that all items in the request are valid and approved.

Request

Path Params
id
string 
required
Request ID

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/requests//verify'

Responses

🟢200Success
application/json
Body
id
string 
required
ID
title
string 
required
Title of request
status
enum<string> 
required
Status of request. Primary indicator of request's completion status.
Allowed values:
INCOMPLETEPARTIALLY_SUBMITTEDREJECTEDCOMPLETEDVERIFIEDEXPIREDCLOSED
items
array[object (RequestItem) {9}] 
required
Items included in request
type
enum<string> 
required
Type of the request item.
Allowed values:
STANDARDE_SIGNATUREQUESTION
name
string 
required
Item name.
description
string  | null 
optional
Item description.
status
enum<string> 
optional
Status of the request item.
Allowed values:
INCOMPLETEPARTIALLY_SUBMITTEDREJECTEDCOMPLETEDVERIFIEDEXPIREDCLOSED
required
boolean 
required
Indicates whether the recipient is required to complete the request item.
Default:
false
question
object (QuestionItem) 
optional
Question item details. Set when type = "QUESTION"
eSignature
object (ESignatureItem) 
optional
E-Signature item details. Set when type = "E_SIGNATURE"
attachments
array[object (RequestItemAttachment) {3}] 
optional
Files attached to the request item, commonly used to display helpful information for completing the request.
assignedTo
object (Assignee) 
optional
Recipient who the item is assigned to
recipients
array[object (Recipient) {7}] 
required
Recipients of request
email
string 
optional
Email of the recipient. Required if phoneNum not set.
firstName
string 
optional
First name of the recipient.
lastName
string 
optional
First name of the recipient.
phone
string 
optional
Phone number (mobile) of the recipient. Required if email not set.
authMethod
object (AuthenticationMethod) 
optional
Method used to authenticate recipient
sendMethod
enum<string> 
optional
How recipient will receive request notifications. Defaults to e-mail.
Allowed values:
DEFAULTEMAILSMSBOTHMULTIPLE
completionOrder
number 
optional
Order that recipient must complete request in. Must be positive integer and must form complete, sequential list with remaining recipients.
links
array[object (RecipientLink) {2}] 
required
Link(s) used by recipients to complete requests.
email
string 
required
Email of recipient, used here to uniquely identify recipient
link
string <uri>
required
Link that recipient can use to complete the request
templateId
integer 
optional
Identifer of template used to create request (if applicable).
from
object (User) 
optional
ID of User making the request.
id
string 
required
ID
firstName
string 
required
lastName
string 
required
email
string 
required
role
enum<string> 
required
Allowed values:
USERADMIN
collaborators
array[object (User) {5}] 
optional
Collaborators receive email updates related to request lifecycle and have limited edit access to the request.
id
string 
required
ID
firstName
string 
required
lastName
string 
required
email
string 
required
role
enum<string> 
required
Allowed values:
USERADMIN
customMessage
string 
optional
Custom message displayed to recipient when viewing the request.
draft
boolean 
optional
Indicates that request is in a "draft" state. When true, request will not be sent to recipients. Defaults to false
Default:
false
reminderInterval
number 
required
Interval at which recipients will receive reminder notifications to complete request, measure in days (ie 7 = 'every week')
dueDate
string <date-time>
optional
Date when request must be completed by
deletionDate
string <date-time>
optional
Date when request and all submitted documents will be deleted. Must be greater than (later than) due date. Defaults to organizational settings.
sendMethod
enum<string> 
required
How recipients will receive request notifications.
Allowed values:
DEFAULTEMAILSMSBOTHMULTIPLE
language
enum<string> 
required
Allowed values:
en-USesarzhfrdehtheiditkoptparu
sendTogether
boolean 
optional
Indicates whether the request needs to be filled out by each recipient separately (false) or if all recipients will collaborate on a single request (true). Defaults to false.
unread
boolean 
required
Indicates whether the request has been viewed in the Pigeon dashboard. By defauly, set to true on creation and updates to false when viewed.
createdAt
string <date-time>
required
Request creation time
updatedAt
string <date-time>
required
Timestamp of most recent request update
completionOrder
boolean 
required
Whether or not completion order is enabled for this request, which enforces the order that recipients can complete their assigned request items.
sendAt
string <date-time>
optional
Scheduled time when request should be sent out to all recipients
Example
{
  "id": "75fa136d-ec1b-4996-9ccd-d0af3e4eea26",
  "title": "suasoria vesica coepi",
  "status": "VERIFIED",
  "items": [
    {
      "type": "STANDARD",
      "name": "trucido alii veritatis",
      "description": "Thema animadverto urbs iure cui cinis degenero auctus. Annus color demo laudantium volup asper. Venio acerbitas comitatus sub.",
      "required": true
    },
    {
      "type": "QUESTION",
      "name": "derideo denego tondeo",
      "description": "Adfero amiculum aetas appositus suus asporto ulciscor. Bene temporibus conservo cunabula. Ubi admiratio velut tertius conventus conatus adeptio voluptate.",
      "required": false,
      "question": {
        "id": "aute consectetur in",
        "questionText": "cillum minim voluptate sed dolore",
        "questionAnswer": "exercitation in deserunt"
      }
    },
    {
      "type": "QUESTION",
      "name": "eveniet quod adfero",
      "description": "Clementia nemo tergo capitulus valde somniculosus. Dignissimos sumo turpis turpis adicio. Volo valetudo deleniti caries spargo suggero culpa color culpa.",
      "required": false,
      "question": {
        "id": "magna aute veniam nulla",
        "questionText": "irure laborum culpa do",
        "questionAnswer": "elit adipisicing aliquip ipsum"
      }
    }
  ],
  "recipients": [
    {
      "email": "Collin.Witting-Heller@hotmail.com",
      "firstName": "Ahmed",
      "lastName": "Bechtelar",
      "phoneNum": "309-207-5861 x599",
      "authMethod": {
        "type": "SECURITY_QUESTION",
        "questionText": "tempor qui Lorem ut",
        "questionAnswer": "et pariatur qui"
      }
    },
    {
      "email": "Jarred.Wiegand@hotmail.com",
      "firstName": "Edgardo",
      "lastName": "Heaney",
      "phoneNum": "(821) 891-3285",
      "authMethod": {
        "type": "SMS_ACCESS_CODE",
        "questionText": "dolor",
        "questionAnswer": "dolor velit aliquip nulla ipsum"
      }
    },
    {
      "email": "Lavern_Hane85@gmail.com",
      "firstName": "Wilmer",
      "lastName": "Swaniawski",
      "phoneNum": "(711) 395-2689 x166",
      "authMethod": {
        "type": "SECURITY_QUESTION",
        "questionText": "deserunt do amet cupidatat",
        "questionAnswer": "pariatur anim sint consequat"
      }
    }
  ],
  "links": [
    {
      "email": "Bret_Daniel55@yahoo.com",
      "link": "https://giving-airport.biz"
    },
    {
      "email": "Lisandro_Vandervort-Rice96@yahoo.com",
      "link": "https://defenseless-wallaby.biz/"
    }
  ],
  "templateId": 93819067,
  "from": {
    "id": "in",
    "firstName": "Nicolas",
    "lastName": "Kshlerin",
    "email": "Estefania.Auer@yahoo.com"
  },
  "collaborators": [
    {
      "id": "Lorem mollit eiusmod exercitation dolor",
      "firstName": "Alize",
      "lastName": "Koss",
      "email": "Murray19@hotmail.com"
    },
    {
      "id": "adipisicing dolor Duis in",
      "firstName": "Einar",
      "lastName": "Beer",
      "email": "Yazmin.Auer23@hotmail.com"
    }
  ],
  "customMessage": "Adnuo atavus aestus viriliter vorago brevis velut absque. Comparo crustulum abscido tum tumultus tonsor quibusdam inventore ut. Atrox fuga beneficium barba.",
  "reminderInterval": 5,
  "dueDate": "2024-10-02T06:44:03.759Z",
  "deletionDate": "2024-10-03T16:34:54.168Z",
  "sendMethod": "EMAIL_AND_SMS",
  "language": "en",
  "sendTogether": false,
  "createdAt": "2024-10-02T14:49:41.023Z",
  "updatedAt": "2024-10-02T11:48:43.101Z"
}
🟠404Record Not Found
Modified at 2024-10-29 16:09:31
Previous
Update Request
Next
Close Request