POST
/
title
/
{id}
/
sign
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>",
      "addr": {
        "recipient_name": "<string>",
        "street1": "<string>",
        "street2": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "oats_names": [
        "<string>"
      ],
      "dob": "<string>",
      "contact_phone": "<string>",
      "contact_email": "<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>"
    }
  ],
  "documents_to_sign": [
    {
      "filename": "<string>",
      "id": "<string>",
      "signer_id": [
        "<string>"
      ],
      "signed_copy": "<string>"
    }
  ]
}'
{
  "id": "<string>",
  "type": "WET_SIGN",
  "status": "<string>",
  "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>",
      "addr": {
        "recipient_name": "<string>",
        "street1": "<string>",
        "street2": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "oats_names": [
        "<string>"
      ],
      "dob": "<string>",
      "contact_phone": "<string>",
      "contact_email": "<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>"
    }
  ],
  "tracking": {
    "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 underlying 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

200
application/json
Signature request created successfully
​
id
string
​
type
enum<string>
Available options:
WET_SIGN,
WET_NOTARY,
RON,
E_SIGN
​
status
string
​
documents_to_sign
object[]
​
created_at
string
​
updated_at
string
​
signers
object[]
​
tracking
object
​
instructions
string
​
metadata
object