Skip to main content
POST
Identify one person by LinkedIn profile URL or by name and company, then return a verified professional email when one is found.
The limit is 3,000 requests per minute per workspace. A successful result costs 2 credits; not_found is not charged.

​
Which inputs can I send?

All five fields belong to the same request. You can send them together. The examples describe minimum information, not mutually exclusive options. Send a person’s name as first_name and last_name; full_name is not a supported request field. Without a LinkedIn profile URL, both name fields and a company name or domain are required. Company name alone or a person’s name alone does not meet the current API’s minimum input requirement. The success example includes all documented response fields. provider and verifier use placeholder labels; optional fields may be absent from a result.
For temporary 502 or 503 responses, use a limited number of retries with increasing delays. If errors persist, stop retrying and contact support. A client timeout does not confirm whether the request completed or was charged.

​
Next step

Use Bulk email finder when you need asynchronous results for up to 100 people.

Authorizations

​
Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json

Provide either a recognized non-empty person profile, or first and last name with a domain or company name. Both complete forms may be supplied together. The JSON body must not exceed 256 KiB.

​
linkedin_profile_url
string

A recognized LinkedIn person-profile URL or identifier. Airscale normalizes supported profile inputs.

Minimum string length: 1
Example:

"https://www.linkedin.com/in/example-person-000000"

​
first_name
string
Minimum string length: 1
​
last_name
string
Minimum string length: 1
​
domain
string
Minimum string length: 1
​
company_name
string
Minimum string length: 1

Response

A professional email result or a not-found result.

​
status
string
required
Allowed value: "success"
​
email
string<email>
required
​
email_status
string

The value is "valid" on a successful result.

​
provider
string
​
verifier
string
​
catch_all
enum<string>
Available options:
yes,
no
​
linkedin_profile_url
string

A recognized LinkedIn person-profile URL or identifier. Airscale normalizes supported profile inputs.

Minimum string length: 1
Example:

"https://www.linkedin.com/in/example-person-000000"