GET
/
title
cURL
curl --request GET \
  --url https://dev.cardinalgray.com/title \
  --header 'Authorization: Bearer <token>'
{
  "entryId": "<string>",
  "vehicle": {
    "vin": "<string>",
    "year": "<string>",
    "make": "<string>",
    "model": "<string>",
    "body": "<string>",
    "type": "AUTO",
    "color": "<string>",
    "color_secondary": "<string>",
    "fuel_type": "<string>",
    "use": "<string>",
    "weight": "<string>",
    "weight_gross": "<string>",
    "weight_unladen": "<string>",
    "width": "<string>",
    "length": "<string>",
    "bhpcc": "<string>",
    "number_of_axles": "<string>",
    "number_of_cylinders": "<string>",
    "license_plate": "<string>",
    "license_plate_type": "<string>",
    "motorcycle_engine_number": "<string>",
    "registration_status": "ACTIVE",
    "registration_expiration_date": "<string>",
    "date_of_sale": "<string>",
    "est_fees": [
      {
        "feeType": "<string>",
        "name": "<string>",
        "value": 123
      }
    ],
    "insurance": {
      "provider_name": "<string>",
      "provider_naic": "<string>",
      "policy_number": "<string>"
    },
    "title": {
      "number": "<string>",
      "issuing_state": "<string>",
      "issuing_county": "<string>",
      "issuance_date": "<string>",
      "brand": "SALVAGE",
      "brand_code": "<string>",
      "odometer_reading": "<string>",
      "odometer_code": "<string>",
      "odometer_code_translation": "ACTUAL",
      "has_liens": true,
      "active_liens": [
        {
          "lien_date": "<string>",
          "lien_amount": "<string>",
          "lien_id": "<string>",
          "lienholder": {
            "name": "<string>",
            "address_org": {
              "recipient_name": "<string>",
              "street1": "<string>",
              "street2": "<string>",
              "city": "<string>",
              "county": "<string>",
              "state": "<string>",
              "zip": "<string>"
            },
            "address_vault": {
              "recipient_name": "<string>",
              "street1": "<string>",
              "street2": "<string>",
              "city": "<string>",
              "county": "<string>",
              "state": "<string>",
              "zip": "<string>"
            },
            "elt_id": "<string>",
            "feid": "<string>",
            "email": "<string>",
            "signatory": {
              "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>"
            },
            "contact_email": "<string>",
            "contact_phone": "<string>"
          }
        }
      ],
      "is_electronic": true,
      "is_and": true,
      "is_or": true,
      "is_tod": true,
      "is_leased": true,
      "previous_title": [
        {
          "number": "<string>",
          "issuing_state": "<string>",
          "issuance_date": "<string>",
          "brand": "SALVAGE",
          "brand_code": "<string>",
          "odometer_reading": "<string>",
          "odometer_code": "<string>",
          "odometer_code_translation": "ACTUAL"
        }
      ],
      "number_of_owners": 123,
      "owners": [
        {
          "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>"
        }
      ]
    }
  },
  "status": "<string>",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
vin
string

Vehicle Identification Number (VIN) to search for. Returns a single matching entry if found.

​
stateMap
boolean

When true, returns a mapping of states to entry counts for the USA Map component

​
state
string

Filter entries by a specific US state

​
timeline
integer

Filter entries created within this many milliseconds from now

​
limit
integer

Maximum number of items to return per page. If not provided, returns all matching entries.

​
nextToken
string

Token for fetching the next page of results. Use the value returned from a previous response.

Response

200
application/json

List of title entries or single entry (if vin used)

A single title entry (returned when using vin)