Ownership

Ownership by address

Find everyone on file at a street address, with optional vehicle history, compliance-grade Do-Not-Call flags, or household demographics. Enterprise only. Charged only when a match is found.

Checking account...
GET
/v1/ownership/address

Find everyone on file at a street address, with optional vehicle history, compliance-grade Do-Not-Call flags, or household demographics. Enterprise only. Charged only when a match is found.

Authorization

ApiKeyQuery
key<token>

Your CarsXE API key, passed as the key query parameter.

In: query

Query Parameters

address*string

Street address only, max 100 characters.

Lengthlength <= 100
zip*string

5-digit US ZIP, optionally ZIP+4.

variant?string

vehicle_history or compliance — mutually exclusive. Unrecognized values are rejected with 400.

Value in"vehicle_history" | "compliance"
include?string

Only recognized value is demographics. Triggers a separately billed enrichment lookup. Unrecognized values are rejected with 400.

Value in"demographics"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

{
  "success": true,
  "input": {
    "address": "123 Example St",
    "zip": "90210"
  },
  "count": 2,
  "matches": [
    {
      "record_id": "2074367570",
      "first_name": "John",
      "last_name": "Sample",
      "address": {
        "street": "123 Example St",
        "city": "Beverly Hills",
        "state": "CA",
        "zip": "90210"
      },
      "emails": [
        {
          "address": "john.sample@gmail.com",
          "last_seen": ""
        }
      ],
      "phones": [
        {
          "number": "3105551901",
          "type": "",
          "dnc": false
        }
      ]
    },
    {
      "record_id": "7304690614",
      "first_name": "Jane",
      "last_name": "Sample",
      "address": {
        "street": "123 Example St",
        "city": "Beverly Hills",
        "state": "CA",
        "zip": "90210"
      },
      "emails": [
        {
          "address": "jane.sample@yahoo.com",
          "last_seen": ""
        }
      ],
      "phones": [
        {
          "number": "3105558018",
          "type": "",
          "dnc": false
        }
      ]
    }
  ],
  "error": ""
}
{
  "success": false,
  "count": 0,
  "matches": [],
  "error": "invalid_inputs",
  "message": "Invalid inputs. address and zip are required (address max 100 characters)"
}

{
  "success": false,
  "message": "Missing API key"
}

{
  "success": false,
  "count": 0,
  "matches": [],
  "error": "api_not_enabled",
  "message": "The Ownership API is not enabled for this API key. To enable, please contact support."
}
{
  "success": false,
  "count": 0,
  "matches": [],
  "error": "no_data",
  "message": "No ownership records found for this address"
}
{
  "success": false,
  "message": "API usage limit exceeded",
  "usage": {
    "current": 1000,
    "limit": 1000,
    "remaining": 0
  }
}
{
  "success": false,
  "message": "The Ownership API is temporarily unavailable."
}