# Enrichment
## OpenAPI Specification
```yaml
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/lead/enrichment:
post:
summary: Enrichment
deprecated: false
description: >-
One endpoint, full contact records. Submit any partial input: name,
email, LinkedIn URL, company, or any combination, and Enrichment returns
a complete profile: verified email, mobile phone, title, seniority,
company, industry, size, and location. Cleans dirty CRM data, completes
form-fill leads, and powers personalized outreach at scale.
Accepted fields
At least one identifier: email, linkedin, or first_name + last_name + company_name.
Response
Synchronous (immediate JSON) or asynchronous (if callback_url is set, results are posted to that URL).
operationId: enrichSingleLead
tags:
- 👤 Lead Resolution
- Enrichment
parameters: []
requestBody:
content:
application/json:
schema:
type: object
x-apidog-refs:
01KMJMTMH0FQM7H371EWYSMKH4:
$ref: '#/components/schemas/EnrichmentRequest'
x-apidog-overrides:
metadata: null
callback_url:
type: string
format: uri
description: Callback URL for asynchronous response (optional)
examples:
- https://webhook.site/your-id
first_name: &ref_0
type: string
description: >-
The person's first name. It doesn't need to be in
lowercase.
examples:
- John
last_name: &ref_1
type: string
description: >-
The person's last name. It doesn't need to be in
lowercase.
examples:
- Doe
email_work:
type: string
format: email
description: Work email
examples:
- john@acme.com
email_personal:
type: string
format: email
description: Personal email
linkedin_url: &ref_3
type: string
description: Full LinkedIn profile URL
examples:
- https://www.linkedin.com/in/john-doe
company_name: &ref_4
type: string
description: >-
The company name from which you want to find the lead.
For example, "google". Note that providing the domain
name gives better results as it removes the conversion
from the company name. The company name doesn't need to
be in lowercase.
examples:
- Acme Inc
job_title: &ref_5
type: string
description: The person's job title.
examples:
- VP Sales
phone: &ref_6
type: string
description: >-
The person's phone number, which can be a mobile or
landline number.
examples:
- '+15551234567'
email: &ref_2
type: string
format: email
description: Work email
examples:
- john@acme.com
x-apidog-orders:
- 01KMJMTMH0FQM7H371EWYSMKH4
properties:
first_name: *ref_0
last_name: *ref_1
email: *ref_2
linkedin_url: *ref_3
company_name: *ref_4
job_title: *ref_5
phone: *ref_6
x-apidog-ignore-properties:
- first_name
- last_name
- email
- linkedin_url
- company_name
- job_title
- phone
examples:
byLinkedIn:
value:
first_name: John
last_name: Doe
email: john@acme.com
phone: '+11234567890'
linkedin_url: https://www.linkedin.com/in/john-doe
company_name: Acme Inc
job_title: VP Sales
responses:
'200':
description: >-
Enrichment succeeded. Returns the full lead profile with contact
data.
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: string
examples:
- https://www.linkedin.com/in/john-doe/
email_work:
type: object
properties:
email:
type: string
validity:
type: string
x-apidog-orders:
- email
- validity
required:
- 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: []
email_alt:
type: object
properties:
email:
type: string
validity:
type: string
x-apidog-orders:
- email
- validity
required:
- email
- validity
x-apidog-ignore-properties: []
phone:
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: []
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: []
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: string
revenue:
type: string
employee_count:
type: string
year_founded:
type: string
address:
type: object
properties:
street:
type: string
zip_code:
type: string
city:
type: string
state:
type: string
x-apidog-orders:
- street
- zip_code
- city
- state
x-apidog-ignore-properties: []
about:
type: string
required:
- address
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: string
city:
type: string
state:
type: string
x-apidog-orders:
- street
- zip_code
- city
- state
x-apidog-ignore-properties: []
required:
- 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:
first_name:
type: string
last_name:
type: string
email_work:
type: string
linkedin_url:
type: string
company_name:
type: string
job_title:
type: string
required:
- first_name
- last_name
- email_work
- linkedin_url
- company_name
- job_title
x-apidog-orders:
- first_name
- last_name
- email_work
- linkedin_url
- company_name
- job_title
x-apidog-ignore-properties: []
required:
- success
- message
- lead
- payload
x-apidog-orders:
- success
- message
- lead
- payload
x-apidog-ignore-properties: []
example:
success: true
message: Lead successfully enriched
lead:
name_first: John
name_last: Doe
linkedin_url: linkedin.com/in/john-doe
email_work:
email: jdoe.work@example.com
validity: valid
email_personal:
email: jdoe.personal@example.com
validity: valid
email_alt:
email: jdoe.alt@example.com
validity: valid
phone:
number: +1-202-555-0143
line_type: landline
validity: valid
phone_alt:
number: +1-202-555-0143
line_type: landline
validity: valid
job_title: VP Sales
job_seniority: Executive
job_department: Sales
company:
name: Acme Inc
domain: acme.com
website_url: https://www.acme.com
linkedin_url: https://www.linkedin.com/company/acme-inc
industry: Software Development
revenue: $10M - $50M
employee_count: 100-500
year_founded: '2015'
address:
street: 123 Tech Boulevard
zip_code: '94105'
city: San Francisco
state: CA
about: Some description
address:
street: 456 Market Street, Apt 12B
zip_code: '94104'
city: San Francisco
state: CA
payload:
first_name: John
last_name: Doe
email_work: john@acme.com
linkedin_url: https://www.linkedin.com/in/john-doe
company_name: Acme Inc
job_title: VP Sales
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-31382856-run
components:
schemas:
EnrichmentRequest:
type: object
description: >-
Input for lead enrichment. At least one identifier must be provided
(email, LinkedIn, or name + company).
properties:
first_name:
type: string
description: Lead first name
examples:
- John
last_name:
type: string
description: Lead last name
examples:
- Doe
email:
type: string
format: email
description: Work email
examples:
- john@acme.com
linkedin_url:
type: string
description: Full LinkedIn profile URL
examples:
- https://www.linkedin.com/in/john-doe
company_name:
type: string
description: Company name
examples:
- Acme Inc
job_title:
type: string
description: Current job title
examples:
- VP Sales
phone:
type: string
description: Phone number
examples:
- '+15551234567'
x-apidog-orders:
- first_name
- last_name
- email
- linkedin_url
- company_name
- job_title
- phone
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: []
```