Full Identity

Complete identity resolution — build a verified profile from any starting fragment (phone, name, address, or email).

Credits: 15 per request

This is the most comprehensive endpoint. It chains multiple data sources to build a complete profile from minimal input.

Request

POST /v1/full-identity

Parameters

Provide at least one of the following:

Field	Type	Required	Description
phone	string	No*	Phone number
name	object	No*	Person's name
name.first	string	—	First name
name.last	string	—	Last name
address	object	No*	Address
address.street	string	—	Street address
address.city	string	—	City
address.state	string	—	State
address.zip	string	—	ZIP code
email	string	No*	Email address

*At least one field group is required. More input = higher confidence.

Example — Starting from phone only

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

Example — Starting from name + city

curl -X POST https://api.braidisdata.com/v1/full-identity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": { "first": "John", "last": "Smith" },
    "address": { "city": "Austin", "state": "TX" }
  }'

Response

{
  "success": true,
  "credits_used": 15,
  "credits_remaining": 985,
  "confidence": 0.92,
  "data": {
    "name": {
      "first": "John",
      "last": "Smith",
      "full": "John Smith"
    },
    "phones": [
      {
        "number": "+15551234567",
        "type": "mobile",
        "carrier": "T-Mobile",
        "primary": true
      },
      {
        "number": "+15125559999",
        "type": "landline",
        "primary": false
      }
    ],
    "emails": [
      {
        "address": "john.smith@email.com",
        "primary": true
      }
    ],
    "addresses": [
      {
        "street": "123 Main St",
        "city": "Austin",
        "state": "TX",
        "zip": "78701",
        "type": "current"
      },
      {
        "street": "789 Elm Dr",
        "city": "Houston",
        "state": "TX",
        "zip": "77001",
        "type": "previous"
      }
    ],
    "demographics": {
      "age_range": "35-44",
      "gender": "male"
    },
    "property": {
      "address": "123 Main St, Austin, TX 78701",
      "owner": true,
      "type": "single_family",
      "assessed_value": 425000
    }
  }
}

Response Fields

Field	Type	Description
name	object	Verified full name
phones	array	All known phone numbers with type and primary flag
emails	array	All known email addresses with primary flag
addresses	array	Current and previous addresses
addresses[].type	string	current or previous
demographics	object	Age range and gender estimates
property	object	Property details if the person owns their current residence
property.owner	boolean	Whether they own (vs rent)

Resolution Quality

The more input you provide, the higher the confidence:

Input Provided	Typical Confidence
Phone only	0.70 - 0.85
Name + state	0.50 - 0.70
Name + full address	0.85 - 0.95
Phone + name	0.90 - 0.98
Phone + name + address	0.95 - 1.00

WARNING

Full Identity resolution may take 1-3 seconds longer than simpler lookups, as it chains multiple data sources in sequence.