Ownership

Ownership by phone

Resolve people and contact details from a US phone number. Accepts one number or a comma-separated list (max 100). Enterprise only. Charged only when a match is found — billed per match returned, not a flat rate per request. Partial hits still 200 and bill only the matches.

Checking account...
GET
/v1/ownership/phone

Resolve people and contact details from a US phone number. Accepts one number or a comma-separated list (max 100). Enterprise only. Charged only when a match is found — billed per match returned, not a flat rate per request. Partial hits still 200 and bill only the matches.

Authorization

ApiKeyQuery
key<token>

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

In: query

Query Parameters

phone*string

One or more US 10-digit phone numbers, comma-separated. Formatting and a leading +1 / 1 country code are stripped. Max 100 unique numbers.

include?string

Comma-separated subset of demographics,emails,phones,vehicle_history. Omit to get everything back by default — this only narrows the response, it doesn't change what's fetched or billed.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

{
  "success": true,
  "input": {
    "phones": [
      "3105551901"
    ]
  },
  "count": 1,
  "matches": [
    {
      "queried_phone": "3105551901",
      "record_id": "2074367570",
      "first_name": "John",
      "last_name": "Sample",
      "age": "45",
      "gender": "Male",
      "address": {
        "street": "123 Example St",
        "city": "Beverly Hills",
        "state": "CA",
        "zip": "90210"
      },
      "vin": "1FT8X3BT0BEA61538",
      "emails": [
        {
          "address": "john.sample@gmail.com",
          "last_seen": "2026-03-08"
        }
      ],
      "phones": [
        {
          "number": "3105551901",
          "type": "",
          "dnc": false
        }
      ],
      "demographics": {
        "marital_status": "Married",
        "home_owner": "Home Owner",
        "children_in_household": "",
        "veteran_in_household": "",
        "occupation": "President",
        "income_range": "$100,000 - $149,999",
        "net_worth_range": "$250,000 - $499,999",
        "credit_range": "700 - 749"
      },
      "vehicle_history": [
        {
          "make": "Ford",
          "model": "F-350",
          "year": 2011,
          "vin": "1FT8X3BT0BEA61538"
        }
      ]
    }
  ],
  "error": ""
}
{
  "success": false,
  "count": 0,
  "matches": [],
  "error": "invalid_inputs",
  "message": "Invalid inputs. Provide one or more US 10-digit phone numbers (comma-separated on GET, or a phones array on POST)"
}

{
  "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 phone"
}
{
  "success": false,
  "message": "API usage limit exceeded",
  "usage": {
    "current": 1000,
    "limit": 1000,
    "remaining": 0
  }
}
{
  "success": false,
  "message": "The Ownership API is temporarily unavailable."
}