Reverse Phone

Resolve a phone number to the owner's name and address.

Credits: 5 per request

Request

POST /v1/reverse-phone

Parameters

Field	Type	Required	Description
phone	string	Yes	Phone number (E.164 format preferred)

Example

curl -X POST https://api.braidisdata.com/v1/reverse-phone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+15551234567"}'

Response

{
  "success": true,
  "credits_used": 5,
  "credits_remaining": 995,
  "confidence": 0.94,
  "data": {
    "phone": "+15551234567",
    "name": {
      "first": "John",
      "last": "Smith",
      "full": "John Smith"
    },
    "address": {
      "street": "123 Main St",
      "city": "Austin",
      "state": "TX",
      "zip": "78701"
    },
    "line_type": "mobile",
    "carrier": "T-Mobile",
    "demographics": {
      "age_range": "35-44",
      "gender": "male"
    }
  }
}

Response Fields

Field	Type	Description
phone	string	The queried phone number (normalized)
name	object	Owner name (first, last, full)
address	object	Owner address (street, city, state, zip)
line_type	string	mobile, landline, voip
carrier	string	Phone carrier name
demographics.age_range	string	Estimated age range
demographics.gender	string	male, female, unknown

WARNING

Demographics fields are estimates and may not always be available. Check for their presence before using.

Batch Requests

For bulk reverse phone lookups, pass an array of phone numbers:

curl -X POST https://api.braidisdata.com/v1/reverse-phone/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phones": ["+15551234567", "+15559876543", "+15550001111"]
  }'

Credits charged: 5 per phone number that returns a match. Phones with no match cost 0 credits.

{
  "success": true,
  "credits_used": 10,
  "credits_remaining": 990,
  "results": [
    { "phone": "+15551234567", "match": true, "data": { ... } },
    { "phone": "+15559876543", "match": true, "data": { ... } },
    { "phone": "+15550001111", "match": false, "data": null }
  ]
}