Caller ID

Resolve a phone number to the caller's name.

Credits: 2 per request

Request

POST /v1/caller-id

Parameters

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

Example

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

Response

{
  "success": true,
  "credits_used": 2,
  "credits_remaining": 998,
  "confidence": 0.96,
  "data": {
    "phone": "+15551234567",
    "name": {
      "first": "John",
      "last": "Smith",
      "full": "John Smith"
    },
    "line_type": "mobile"
  }
}

Response Fields

Field	Type	Description
phone	string	The queried phone number (normalized)
name.first	string	First name
name.last	string	Last name
name.full	string	Full formatted name
line_type	string	mobile, landline, voip, toll_free, unknown

TIP

If you also need the address, use Reverse Phone instead (5 credits) to get name + address in one call.