Universal Identity

Every identity signal on a person in one call: work and personal emails, device IDs, and hashed emails. Accepts hashed or plaintext email and IP address inputs.

Single mode: provide a pre-computed md5, a plaintext email, or an IPv4 or IPv6 ip_address with an optional user_agent. USA IPs only! Choose exactly one identifier family. The response carries every identity signal on the person: hems (MD5 + SHA-256 for each known personal and business email), maids (mobile advertising IDs), personal_emails, and business_emails. Email fields are MD5-hashed unless you send a plaintext email. A match returns HTTP 200 { result: {...} }; a miss returns HTTP 404 { result: {} }.

Batch mode: send an md5s or ips array (max 1,000). MD5s are lowercased and de-duplicated; equivalent IP spellings are de-duplicated while preserving the first input. One malformed MD5 fails the whole request with HTTP 400 before any lookups run. Otherwise the response is always HTTP 200 with results, match_count, credits_charged, and credits_exhausted. Every matched result returns md5; IP batch results also echo ip_address. Inputs with no data are omitted; email fields are always MD5-hashed in batch results. Processing stops once the account’s remaining credits are exhausted (credits_exhausted: true).

Billing: the full configured per-record cost when both the profile and MAID data match; 1 credit when only one of the two sources resolves (partial data); 0 credits for a miss (single-mode 404, or omitted from batch results). IP-sourced matches add 1 credit (full 4, partial 2 at the default price). Request errors (4xx) are not billed.

POST /api/v1/identity/person

cURL

single

curl --request POST \
  --url https://api.rb2b.com/api/v1/identity/person \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "md5": "5d41402abc4b2a76b9719d911017c592"
}
'

200

{
  "result": {
    "md5": "5d41402abc4b2a76b9719d911017c592",
    "ip_address": "203.0.113.42",
    "hems": [
      {
        "md5": "5d41402abc4b2a76b9719d911017c592",
        "sha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
      }
    ],
    "maids": [
      {
        "device_id": "6D92078A-8246-4BA4-AE5B-76104861E7DC",
        "device_type": "idfa"
      }
    ],
    "personal_emails": [
      "<string>"
    ],
    "business_emails": [
      "<string>"
    ]
  }
}

Authorizations

X-Api-Key · string · header · required

Per-account API key. Also accepted as Api-Key or Authorization: Bearer <key>.

Body

application/json

Option 1

Option 2

Option 3

Option 4

Option 5

Choose exactly one single or batch identifier mode: md5/email, md5s, ip_address, or ips.

md5 · string · required

MD5 hash of the lowercased, trimmed email address.

Pattern: ^[a-fA-F0-9]{32}$

Example:

"5d41402abc4b2a76b9719d911017c592"

email · string<email>

Plaintext email address. When present, email fields in the response are returned in plaintext.

Example:

"[e-mail]"

md5s · string[]

Batch lookup: up to 1,000 MD5 hashes. When present, the request is processed in batch mode. Cannot be combined with IP inputs.

Required array length: 1 - 1000 elements

Pattern: ^[a-fA-F0-9]{32}$

ip_address · string

Single IPv4 or IPv6 address. USA IPs only! Cannot be combined with email inputs.

Example:

"203.0.113.42"

user_agent · string

Optional browser user agent for a single IP lookup.

ips · string[]

Batch lookup of up to 1,000 IPv4 or IPv6 addresses. USA IPs only! Cannot be combined with email inputs.

Required array length: 1 - 1000 elements

Response

200

application/json

Identity data found

Option 1

Option 2

Single-lookup response (md5, email, or ip_address input).

result · object · required

Every identity signal on the matched person.

Show child attributes