Ownership

Ownership by ZIP

Search a ZIP code for people matching optional gender, age, and income filters. Paginated. Enterprise only. Charged only when records are returned — billed per record on the page, up to 100 per call at max `limit`, so usage can scale quickly.

Checking account...
GET
/v1/ownership/zip

Search a ZIP code for people matching optional gender, age, and income filters. Paginated. Enterprise only. Charged only when records are returned — billed per record on the page, up to 100 per call at max limit, so usage can scale quickly.

Authorization

ApiKeyQuery
key<token>

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

In: query

Query Parameters

zip*string

Exactly 5 digits.

Match^[0-9]{5}$
gender?string

M or F, case-insensitive.

Value in"M" | "F" | "m" | "f"
min_age?string

Whole number. Optional — only forwarded upstream when provided.

max_age?string

Whole number. Optional — only forwarded upstream when provided.

income?string

Full income label, letter code, or a loose variant of either.

page?string

Page number (default 1).

Default"1"
limit?string

Page size (default 15, max 100). Each record returned is billed individually, so a full page at limit=100 bills up to 100 units in one call.

Default"15"
include?string

Comma-separated subset of demographics,emails,phones,vehicle_history. Omit it to get everything — same behavior as VIN/Person.

variant?string

Legacy, deprecated. vehicle_history is accepted and echoed back for backward compatibility, but no longer changes the response — use include instead.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

{
  "success": true,
  "zip": "00000",
  "filters": {},
  "page": 1,
  "limit": 15,
  "count": 1,
  "records": [
    {
      "record_id": "2104840276",
      "first_name": "Victoria",
      "last_name": "Rose",
      "age": "34",
      "gender": "F",
      "address": {
        "street": "141 Hardwood Ln SE",
        "city": "Kalkaska",
        "state": "MI",
        "zip": "49646"
      },
      "vin": "1HGBH41JXMN109186",
      "vehicle": {
        "make": "Honda",
        "model": "Civic",
        "year": 2021
      },
      "emails": [
        {
          "address": "victoria.rose@example.com",
          "last_seen": "2026-07-11"
        },
        {
          "address": "vrose2@gmail.com",
          "last_seen": ""
        }
      ],
      "phones": [
        {
          "number": "2314567890",
          "dnc": false
        },
        {
          "number": "2319876543",
          "dnc": true
        }
      ],
      "demographics": {
        "marital_status": "Married",
        "home_owner": "Home Owner",
        "children_in_household": "1",
        "veteran_in_household": "",
        "occupation": "Professional",
        "income_range": "F. $50,000-$59,999",
        "net_worth_range": "D. $50,000-$99,999",
        "credit_range": "H. 700-749"
      },
      "vehicle_history": [
        {
          "make": "Honda",
          "model": "Civic",
          "year": 2021,
          "vin": "1HGBH41JXMN109186"
        }
      ]
    }
  ],
  "error": ""
}

{
  "success": false,
  "zip": "",
  "filters": {},
  "page": 1,
  "limit": 15,
  "count": 0,
  "records": [],
  "error": "invalid_zip",
  "message": "Invalid ZIP code. Must be a 5-digit US ZIP code"
}

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

{
  "success": false,
  "zip": "49646",
  "filters": {},
  "page": 1,
  "limit": 15,
  "count": 0,
  "records": [],
  "error": "api_not_enabled",
  "message": "The Ownership API is not enabled for this API key. To enable, please contact support."
}
{
  "success": false,
  "zip": "49646",
  "filters": {},
  "page": 1,
  "limit": 15,
  "count": 0,
  "records": [],
  "error": "no_data",
  "message": "No records available for this Ownership ZIP query"
}
{
  "success": false,
  "message": "API usage limit exceeded",
  "usage": {
    "current": 1000,
    "limit": 1000,
    "remaining": 0
  }
}
{
  "success": false,
  "message": "The Ownership API is temporarily unavailable."
}