# Deanonymization
## OpenAPI Specification
```yaml
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/lead/deanonymization:
post:
summary: Deanonymization
deprecated: false
description: >-
Stop losing 97% of your website traffic to anonymity. Deanonymization
resolves visitor IPs into the actual individual behind the session:
name, verified email, mobile phone, and firmographic context. Power
retargeting, instant SDR follow-up, and personalized site experiences
for the people who matter most: the ones already on your site.
Identifiers (at least one)
ip
Visitor IPv4 address
maid
Mobile Advertising ID (IDFA on iOS, GAID on Android)
md5
MD5 hash of visitor email
sha256
SHA256 hash of visitor email
operationId: deanonymizeSingle
tags:
- 👤 Lead Resolution
- Deanonymization
parameters: []
requestBody:
content:
application/json:
schema:
type: object
x-apidog-refs:
01KMJMXGXCJWM59A45B8NZBSCJ:
$ref: '#/components/schemas/DeanonymizationRequest'
x-apidog-overrides:
metadata: null
super_enrichment_email:
type: boolean
description: >-
When true, enables enhanced logic to return better email
results for the lead.
super_enrichment_phone:
type: boolean
description: >-
When true, enables enhanced logic to return better phone
results for the lead.
ip: &ref_0
type: string
description: >-
The IP address of a web visitor or lead. Used for
deanonymization endpoints.
examples:
- 8.8.8.8
maid: &ref_1
type: string
description: >-
The Mobile Advertising ID (MAID), used for cross-device
identity resolution and mobile ad targeting.
examples:
- aebE52A8-6f23-4f9f-b38f-9473f6d9f1b2
md5: &ref_2
type: string
description: >-
A hashed email ID (HEM), MD5 or SHA-256, used for
privacy-safe identity matching and custom audience
activation on ad platforms.
examples:
- d41d8cd98f00b204e9800998ecf8427e
sha256: &ref_3
type: string
description: SHA256 hash of the visitor email
examples:
- >-
9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08
callback_url:
type: string
format: uri
description: Callback URL for asynchronous response
examples:
- https://webhook.site/your-id
required: []
x-apidog-orders:
- 01KMJMXGXCJWM59A45B8NZBSCJ
properties:
ip: *ref_0
maid: *ref_1
md5: *ref_2
sha256: *ref_3
x-apidog-ignore-properties:
- ip
- maid
- md5
- sha256
example:
ip: 8.8.8.8
maid: aebE52A8-6f23-4f9f-b38f-9473f6d9f1b2
md5: d41d8cd98f00b204e9800998ecf8427e
sha256: 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08
responses:
'200':
description: Deanonymization succeeded
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
message:
type: string
lead:
type: object
properties:
name_first:
type: string
examples:
- John
name_last:
type: string
examples:
- Doe
linkedin_url:
type: 'null'
examples:
- https://www.linkedin.com/in/john-doe/
email_work:
type: object
examples:
- doe.john@work.com
properties:
email:
type: string
validity:
type: string
required:
- email
- validity
x-apidog-orders:
- email
- validity
x-apidog-ignore-properties: []
email_personal:
type: object
properties:
email:
type: string
validity:
type: string
x-apidog-orders:
- email
- validity
required:
- email
- validity
x-apidog-ignore-properties: []
nullable: true
email_alt:
type: object
properties:
email:
type: string
validity:
type: string
x-apidog-orders:
- email
- validity
required:
- email
- validity
x-apidog-ignore-properties: []
nullable: true
phone:
type: object
examples:
- 213-555-0123
properties:
number:
type: string
line_type:
type: string
validity:
type: string
required:
- number
- line_type
- validity
x-apidog-orders:
- number
- line_type
- validity
x-apidog-ignore-properties: []
phone_alt:
type: object
properties:
number:
type: string
line_type:
type: string
validity:
type: string
x-apidog-orders:
- number
- line_type
- validity
required:
- number
- line_type
- validity
x-apidog-ignore-properties: []
nullable: true
job_title:
type: string
examples:
- Developer
job_seniority:
type: string
examples:
- Senior
job_department:
type: string
examples:
- IT
company:
type: object
properties:
name:
type: string
examples:
- Springbolt
domain:
type: string
examples:
- springboltgroup.com
website_url:
type: string
examples:
- https://www.springboltgroup.com/
linkedin_url:
type: string
examples:
- >-
https://www.linkedin.com/company/springbolt-group-llc
industry:
type: 'null'
revenue:
type: string
employee_count:
type: string
year_founded:
type: 'null'
address:
type: object
properties:
street:
type: string
zip_code:
type: string
city:
type: string
state:
type: string
required:
- street
- zip_code
- city
- state
x-apidog-orders:
- street
- zip_code
- city
- state
x-apidog-ignore-properties: []
about:
type: string
nullable: true
required:
- name
- domain
- website_url
- linkedin_url
- industry
- revenue
- employee_count
- year_founded
- address
- about
x-apidog-orders:
- name
- domain
- website_url
- linkedin_url
- industry
- revenue
- employee_count
- year_founded
- address
- about
x-apidog-ignore-properties: []
address:
type: object
properties:
street:
type: string
zip_code:
type: 'null'
city:
type: string
state:
type: string
required:
- street
- zip_code
- city
- state
x-apidog-orders:
- street
- zip_code
- city
- state
x-apidog-ignore-properties: []
required:
- name_first
- name_last
- linkedin_url
- email_work
- email_personal
- email_alt
- phone
- job_title
- job_seniority
- job_department
- company
- address
x-apidog-orders:
- name_first
- name_last
- linkedin_url
- email_work
- email_personal
- email_alt
- phone
- phone_alt
- job_title
- job_seniority
- job_department
- company
- address
x-apidog-ignore-properties: []
payload:
type: object
properties:
ip:
type: string
required:
- ip
x-apidog-orders:
- ip
x-apidog-ignore-properties: []
required:
- success
- lead
- payload
x-apidog-orders:
- success
- message
- lead
- payload
x-apidog-ignore-properties: []
example: "{\r\n \"success\": true,\r\n \"lead\": {\r\n \"name_first\": \"John\",\r\n \"name_last\": \"Doe\",\r\n \"linkedin_url\": \"linkedin.com/in/john-doe\",\r\n \"job_title\": \"Professor\",\r\n \"email_personal\": {\r\n \"email\": \"johndoe@gmail.com\",\r\n \"validity\": \"valid\"\r\n },\r\n \"email_work\": {\r\n \"email\": \"johndoe@company.com\",\r\n \"validity\": \"valid\"\r\n },\r\n \"email_alt\": {\r\n \"email\": \"johndoe123@outlook.com\",\r\n \"validity\": \"likely\"\r\n },\r\n \"phone\": {\r\n \"number\": \"+11234567890\",\r\n \"line_type\": \"mobile\",\r\n \"validity\": \"valid\"\r\n },\r\n \"phone_alt\": {\r\n \"number\": \"+11234567890\",\r\n \"line_type”: \"landline\",\r\n \"validity\": \"likely\"\r\n },\r\n \"company\": {\r\n \"name\": \"Company Example\",\r\n \"industry\": \"Transportation\",\r\n \"linkedin_url\": \"linkedin.com/company/example\",\r\n \"website_url\": \"https://www.example.com\",\r\n \"address\": {\r\n \"street\": \"1st Street\",\r\n \"zip_code\": \"12345\",\r\n \"city\": \"Detroit\",\r\n \"state\": \"Michigan\"\r\n }\r\n },\r\n \"address\": {\r\n \"street\": \"1st Street\",\r\n \"zip_code\": \"12345\",\r\n \"city\": \"Detroit\",\r\n \"state\": \"Michigan\"\r\n }\r\n },\r\n \"metada\": {\r\n \"website_domain\": \"example.com\"\r\n },\r\n \"payload\": {\r\n \"md5\": \"a66c7e69fcf6a224d9b9686a14d62766\"\r\n }\r\n}"
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: 👤 Lead Resolution
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/1235890/apis/api-31382857-run
components:
schemas:
DeanonymizationRequest:
type: object
description: >-
Input for visitor deanonymization. Accepts IP, MAID (Mobile Advertising
ID), or MD5/SHA256 hashed email (HEM). At least one identifier is
required.
properties:
ip:
type: string
description: Visitor IP address
examples:
- 8.8.8.8
maid:
type: string
description: Mobile Advertising ID (IDFA/GAID)
examples:
- aebE52A8-6f23-4f9f-b38f-9473f6d9f1b2
md5:
type: string
description: MD5 hash of the visitor email
examples:
- d41d8cd98f00b204e9800998ecf8427e
sha256:
type: string
description: SHA256 hash of the visitor email
examples:
- 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08
x-apidog-orders:
- ip
- maid
- md5
- sha256
x-apidog-ignore-properties: []
x-apidog-folder: ''
securitySchemes:
bearerAuth:
type: jwt
scheme: bearer
bearerFormat: JWT
description: >-
Organization JWT or API key from Core API. Send in header:
Authorization: Bearer {token}
sysAuth:
type: apikey
in: header
name: x-sys-key
description: >-
System authentication key for internal endpoints. Only for inter-service
calls.
servers:
- url: https://api.lead.springbolt.app
description: Prod Env
security: []
```