curl --request POST \
--url https://api.rb2b.com/api/v1/ip_to_hem \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
"include_sha256": false
}
'import requests
url = "https://api.rb2b.com/api/v1/ip_to_hem"
payload = {
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
"include_sha256": False
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ip_address: '203.0.113.42',
user_agent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36',
include_sha256: false
})
};
fetch('https://api.rb2b.com/api/v1/ip_to_hem', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"results": [
{
"md5": "5d41402abc4b2a76b9719d911017c592",
"score": 0.9,
"sha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
}
]
}{
"error": "missing ip_address"
}{
"error": "missing_api_key"
}{
"error": "insufficient_api_credits",
"required": "1.0",
"remaining": "0.0"
}{
"error": "service_unavailable_for_key"
}{
"results": [
"<unknown>"
]
}IP → Hashed Email
Resolve an IP (and browser details) into the visitor’s hashed email.
Provide an IPv4 or IPv6 ip_address (optionally with the visitor’s user_agent). We use our proprietary identity resolution technology to derive and return up to 3 matches ordered by descending confidence score; set include_sha256 to also return each match’s SHA-256 hashed email.
Billing: 1 credit per successful lookup (HTTP 200), regardless of how many matches are returned. Misses (404) and request errors (4xx) are not billed.
curl --request POST \
--url https://api.rb2b.com/api/v1/ip_to_hem \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
"include_sha256": false
}
'import requests
url = "https://api.rb2b.com/api/v1/ip_to_hem"
payload = {
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
"include_sha256": False
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ip_address: '203.0.113.42',
user_agent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36',
include_sha256: false
})
};
fetch('https://api.rb2b.com/api/v1/ip_to_hem', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"results": [
{
"md5": "5d41402abc4b2a76b9719d911017c592",
"score": 0.9,
"sha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
}
]
}{
"error": "missing ip_address"
}{
"error": "missing_api_key"
}{
"error": "insufficient_api_credits",
"required": "1.0",
"remaining": "0.0"
}{
"error": "service_unavailable_for_key"
}{
"results": [
"<unknown>"
]
}Authorizations
Per-account API key. Also accepted as Api-Key or Authorization: Bearer <key>.
Body
IPv4 or IPv6 address of the visitor.
"203.0.113.42"
Visitor's browser User-Agent. Optional; improves match confidence when provided.
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
Also include each match's SHA-256 hashed email as sha256.
Response
Matches found (1 credit charged)
Up to 3 hashed-email matches, ordered by descending score.
Show child attributes
Show child attributes