---
title: "Email Lookup (GET)"
method: GET
path: "/v1/email-lookup"
tags: ["Lookup API"]
---

# Email Lookup (GET)

`GET /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`

Same as POST /v1/email-lookup, with the email and the optional hints as query parameters, for consistency with the IP and domain lookups. Prefer POST where possible: with GET the email address ends up in URLs, browser history and server logs. Available on every plan. Credits are only consumed when a profile is found.

## Query parameters

- `email` string, required
- `firstName` string
- `lastName` string
- `companyName` string
- `companyDomain` string
- `datasetId` string

## Response `200`

Successfully retrieved contact profile

- ContactProfileDetails: Professional profile of a contact, returned when the email address is matched
  - `email` string: Email address that was looked up
  - `fullName` string: Full name of the contact
  - `headline` string: Profile headline
  - `linkedinUrl` string: LinkedIn profile URL
  - `seniority` string: Seniority level
  - `jobFunction` string: Job function
  - `location` string: Location of the contact
  - `languages` Language[]: Languages the contact speaks
    - `name` string: Language name
    - `proficiency` string: Proficiency level
  - `experience` Experience[]: Work experience, most recent first
    - `title` string: Job title
    - `companyName` string: Company name
    - `startYear` integer: Start year
    - `endYear` integer: End year, empty for the current position
    - `current` boolean: Whether this is a current position

## Other responses

- `400`: Bad Request: The request is invalid or malformed (missing/incorrect parameters).
- `402`: Payment Required: The client has exceeded credit limits.
- `403`: Forbidden: The authenticated user does not have permission to access this resource.
- `404`: Not Found: The requested resource does not exist.
- `409`: Conflict: The request could not be completed due to a resource state conflict.
- `429`: Too Many Requests: Rate limit exceeded. The client has sent too many requests in a given time period
- `500`: Interval Server Error: An unexpected error occurred on the server.

---

[API](https://skmtc.dev/leadboxer/apis/leadboxer-api.md) · [All operations](https://skmtc.dev/leadboxer/apis/leadboxer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leadboxer/apis/leadboxer-api/revisions/34249b480395?raw)