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

{
  "result": {
    "md5": "5d41402abc4b2a76b9719d911017c592",
    "first_name": "Alice",
    "last_name": "Smith",
    "title": "VP of Marketing",
    "seniority": "vp",
    "functional_area": "Marketing",
    "current_industry": "Computer Software",
    "country": "United States",
    "linkedinurl": "https://www.linkedin.com/in/alice-123",
    "current_company": "Acme",
    "current_company_linkedinurl": "https://www.linkedin.com/company/acme",
    "current_company_url": "https://acme.com",
    "company_employee_count": "120",
    "company_employee_range": "51-200",
    "company_revenue_range": "$10M-$50M",
    "work_email_confirmed": "alice@acme.com",
    "work_email_confirmed_md5": "4eb2eb38f58a848b48244e95b1e88bff",
    "work_email_confirmed_sha256": "973dfe463ec85785f5f95af5ba3906eedb2d931c24e69824a89ea65dba4e813b",
    "work_email_confirmed_status": "2025-11-03",
    "maid": [
      {
        "device_id": "6D92078A-8246-4BA4-AE5B-76104861E7DC",
        "device_type": "idfa"
      }
    ]
  }
}

{
  "error": "missing md5_or_email",
  "max": 1000,
  "invalid": "not-an-md5",
  "index": 3,
  "conflicting": [
    "<string>"
  ]
}

{
  "error": "missing_api_key"
}

{
  "error": "insufficient_api_credits",
  "required": "1.0",
  "remaining": "0.0"
}

{
  "error": "service_unavailable_for_key"
}

{
  "result": {}
}

Identity Enrichment

Full Business Enrichment

One call returns everything for a contact: work profile, device IDs, hashed emails. Send a hashed or plaintext email, an IP address, or a batch of up to 1,000 values.

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 combines the business profile (same field names as /hem_to_business_profile) with the contact’s mobile advertising IDs. work_email_confirmed is always plaintext, with work_email_confirmed_md5 and work_email_confirmed_sha256 alongside so callers have all three forms; no personal email data is returned. The maid key is always present (null when no MAID data is found), and when the profile lookup misses but MAID data exists the full profile shape is still returned with null values. 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. Processing stops once the account’s remaining credits are exhausted (credits_exhausted: true).

Billing: the full configured per-record cost when both the business 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

identity

business

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

{
  "result": {
    "md5": "5d41402abc4b2a76b9719d911017c592",
    "first_name": "Alice",
    "last_name": "Smith",
    "title": "VP of Marketing",
    "seniority": "vp",
    "functional_area": "Marketing",
    "current_industry": "Computer Software",
    "country": "United States",
    "linkedinurl": "https://www.linkedin.com/in/alice-123",
    "current_company": "Acme",
    "current_company_linkedinurl": "https://www.linkedin.com/company/acme",
    "current_company_url": "https://acme.com",
    "company_employee_count": "120",
    "company_employee_range": "51-200",
    "company_revenue_range": "$10M-$50M",
    "work_email_confirmed": "alice@acme.com",
    "work_email_confirmed_md5": "4eb2eb38f58a848b48244e95b1e88bff",
    "work_email_confirmed_sha256": "973dfe463ec85785f5f95af5ba3906eedb2d931c24e69824a89ea65dba4e813b",
    "work_email_confirmed_status": "2025-11-03",
    "maid": [
      {
        "device_id": "6D92078A-8246-4BA4-AE5B-76104861E7DC",
        "device_type": "idfa"
      }
    ]
  }
}

{
  "error": "missing md5_or_email",
  "max": 1000,
  "invalid": "not-an-md5",
  "index": 3,
  "conflicting": [
    "<string>"
  ]
}

{
  "error": "missing_api_key"
}

{
  "error": "insufficient_api_credits",
  "required": "1.0",
  "remaining": "0.0"
}

{
  "error": "service_unavailable_for_key"
}

{
  "result": {}
}

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"

string<email>

Plaintext email address. Alternative to md5.

Example:

"alice@example.com"

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

Business identity found

Option 1
Option 2

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

result

object

required

Business profile plus MAID data for the matched contact. Additional fields may appear as new data becomes available.

Show child attributes

Identity Enrichment

Email lookups

Identity Resolution

LinkedIn lookups

Search, activity & account

Full Business Enrichment

Authorizations

Body

Response