Skip to main content
POST
/
title
/
{id}
/
sign
cURL
curl --request POST \
  --url https://dev.cardinalgray.com/title/{id}/sign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "signers": [
    {
      "id": "<string>",
      "type": "PERSON",
      "name": "<string>",
      "oats_names": [
        "<string>"
      ],
      "addr": {
        "recipient_name": "<string>",
        "street1": "<string>",
        "street2": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "contact_phone": "<string>",
      "contact_email": "<string>",
      "dob": "<string>",
      "dlid": {
        "number": "<string>",
        "state": "<string>",
        "sex": "<string>",
        "expiration_date": "<string>",
        "first_name": "<string>",
        "middle_name": "<string>",
        "last_name": "<string>",
        "addr": {
          "recipient_name": "<string>",
          "street1": "<string>",
          "street2": "<string>",
          "city": "<string>",
          "county": "<string>",
          "state": "<string>",
          "zip": "<string>"
        }
      },
      "ssn": "<string>",
      "addr_mailing": {
        "recipient_name": "<string>",
        "street1": "<string>",
        "street2": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "insurance": {
        "provider_name": "<string>",
        "provider_naic": "<string>",
        "policy_number": "<string>"
      },
      "ownership_type": "<string>",
      "is_nonobligor": true
    }
  ],
  "documents_to_sign": [
    {
      "filename": "<string>",
      "id": "<string>",
      "signer_id": [
        "<string>"
      ],
      "signed_copy": "<string>"
    }
  ]
}'
{
  "redirect_url": {
    "url": "<string>",
    "message": "<string>"
  },
  "requester_email": "<string>",
  "id": "<string>",
  "type": "WET_SIGN",
  "status": "DRAFT",
  "documents_to_sign": [
    {
      "filename": "<string>",
      "id": "<string>",
      "signer_id": [
        "<string>"
      ],
      "signed_copy": "<string>"
    }
  ],
  "created_at": "<string>",
  "updated_at": "<string>",
  "signers": [
    {
      "id": "<string>",
      "type": "PERSON",
      "name": "<string>",
      "oats_names": [
        "<string>"
      ],
      "addr": {
        "recipient_name": "<string>",
        "street1": "<string>",
        "street2": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "contact_phone": "<string>",
      "contact_email": "<string>",
      "dob": "<string>",
      "dlid": {
        "number": "<string>",
        "state": "<string>",
        "sex": "<string>",
        "expiration_date": "<string>",
        "first_name": "<string>",
        "middle_name": "<string>",
        "last_name": "<string>",
        "addr": {
          "recipient_name": "<string>",
          "street1": "<string>",
          "street2": "<string>",
          "city": "<string>",
          "county": "<string>",
          "state": "<string>",
          "zip": "<string>"
        }
      },
      "ssn": "<string>",
      "addr_mailing": {
        "recipient_name": "<string>",
        "street1": "<string>",
        "street2": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "insurance": {
        "provider_name": "<string>",
        "provider_naic": "<string>",
        "policy_number": "<string>"
      },
      "ownership_type": "<string>",
      "is_nonobligor": true
    }
  ],
  "sign_cert": "<string>",
  "collected_dlid": "<string>",
  "full_export": "<string>",
  "physical_tracking": {
    "status": "<string>",
    "tracking_url": "<string>",
    "label_url": "<string>",
    "shipment_id": "<string>",
    "return_tracking_url": "<string>",
    "return_label_url": "<string>",
    "return_shipment_id": "<string>"
  },
  "instructions": "<string>",
  "metadata": {}
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Unique identifier of the title entry

Query Parameters

​
Action
enum<string>

Special action to perform on an existing signature request. ACTIVATE - Activates a draft signature request, BUMP - Sends a reminder to signers.

Available options:
ACTIVATE,
BUMP

Body

application/json

Customization options for the signature request (e.g., in cases where you don't want to collect signatures from all titled owners).

​
signers
object[]

List of specific people who should sign the documents. If not provided, all current title owners will be included.

​
documents_to_sign
object[]

List of specific documents to be signed. If not provided, all required documents for a given transaction (loan, sale, etc.) will be included.

Response

Signature request created successfully

​
redirect_url
object
​
requester_email
string

Additional notification email for signature completion

​
id
string

Provider-specific ID (NTRZ::id for Notarize, DSGN::id for DocuSign, DMNS::id for Documenso, PNDC::id for Pandadoc)

​
type
enum<string>

Type of signature required

Available options:
WET_SIGN,
WET_NOTARY,
RON,
E_SIGN
​
status
enum<string>

Current status of the signature request

Available options:
DRAFT,
SENT,
OPENED,
COMPLETED,
FAILED,
EXPIRED
​
documents_to_sign
object[]
​
created_at
string

When the request was created

​
updated_at
string

Last status update

​
signers
object[]
​
sign_cert
string

S3 path to signing certification

​
collected_dlid
string

S3 path to collected driver license ID

​
full_export
string

S3 path to full export consisting of sign cert, collected_dlid, and documents_to_sign

​
physical_tracking
object
​
instructions
string

Any special instructions for the signer

​
metadata
object

Additional provider-specific metadata