Lookup API

Email Lookup

Retrieve the professional profile of a contact by email address. Only the email is required; name and company are optional hints that improve matching. Available on every plan. Credits are only consumed when a profile is found.

The same lookup is also available as GET /v1/email-lookup?email=..., but POST is recommended because it keeps the email address out of URLs and server logs.

Returned Data When a match is found, the following fields are returned:

Contact details

  • email
  • fullName
  • headline
  • linkedinUrl
  • seniority
  • jobFunction
  • location

Languages

  • languages[].name
  • languages[].proficiency

Experience

  • experience[].title
  • experience[].companyName
  • experience[].startYear
  • experience[].endYear
  • experience[].current
post/v1/email-lookup

Request

  • Base URL: https://api.leadboxer.com
  • URL: https://api.leadboxer.com/v1/email-lookup
  • Auth: API key in header x-api-key

Query parameters

datasetIdstring

The dataset ID to associate with the operation’s credit. If not specified, a dataset linked to the account will be selected.

Request body

emailstring required

Email address of the contact to enrich

firstNamestring

First name of the contact

lastNamestring

Last name of the contact

companyNamestring

Name of the company the contact works for

companyDomainstring

Domain of the company the contact works for

Example request

{
  "email": "jane.doe@leadboxer.com",
  "firstName": "Jane",
  "lastName": "Doe",
  "companyName": "LeadBoxer",
  "companyDomain": "leadboxer.com"
}

Response

Successfully retrieved contact profile

emailstring

Email address that was looked up

fullNamestring

Full name of the contact

headlinestring

Profile headline

linkedinUrlstring

LinkedIn profile URL

senioritystring

Seniority level

jobFunctionstring

Job function

locationstring

Location of the contact

Example response

{
  "email": "jane.doe@leadboxer.com",
  "fullName": "Jane Doe",
  "headline": "Head of Marketing at LeadBoxer",
  "linkedinUrl": "https://www.linkedin.com/in/janedoe",
  "seniority": "Senior",
  "jobFunction": "Marketing",
  "location": "Amsterdam, North Holland, Netherlands",
  "languages": [
    {
      "name": "English",
      "proficiency": "Native or bilingual proficiency"
    }
  ],
  "experience": [
    {
      "title": "Head of Marketing",
      "companyName": "LeadBoxer",
      "startYear": 2021,
      "endYear": 2024,
      "current": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.