---
title: "Enrich employee (email)"
method: GET
path: "/api/employees/search"
tags: ["Employees"]
---

# Enrich employee (email)

`GET /api/employees/search`

## Request

- Base URL: `https://quickenrich.io`
- URL: `https://quickenrich.io/api/employees/search`
- Auth: HTTP bearer

Search by LinkedIn URL and/or company + name. Returns one employee record. Consumes 1 credit when a real email is returned.

GTM Unlimited only: `reverify=1` reverifies a stored email with Bounceban when `email_verification_date` is missing or older than 7 days. This can add about 30 seconds. Deliverable emails are returned and the verification date is updated. Undeliverable emails are removed and are not charged. Risky and unknown emails stay stored and are omitted unless `include_risky=1`. Either flag without GTM Unlimited returns 403.

## Query parameters

- `linkedin_url` string, uri
- `company_url` string
- `first_name` string
- `last_name` string
- `reverify` boolean
- `include_risky` boolean

## Response `200`

Employee found (data is an object) or not found (data is an empty array with meta.reason EMPLOYEE_NOT_FOUND).

- union
  - object
    - `success` boolean, required
    - `message` string, required
    - `code` integer, required
    - `data` EnrichmentEmployee
      - `first_name` string
      - `last_name` string
      - `title` string
      - `email` string
      - `employee_phone` string
      - `employee_phone_type` string
      - `employee_linkedin` string
      - `email_verification_date` string, date, nullable
      - `company_url` string
      - `company_name` string
      - `email_domain` string
      - `company_linked` string
      - `company_phone` string
      - `industry` string
      - `revenue` string
      - `employee_count` string
      - `address` string
      - `city` string
      - `region_code` string
      - `zip` string
      - `country_code` string
    - `meta` object
      - `credits_used` integer
      - `remaining_credits` integer
      - `reason` 'EMPLOYEE_NOT_FOUND' | 'EMAIL_NOT_FOUND' | 'PHONE_NOT_FOUND' | 'COMPANY_NOT_FOUND': Present on empty/not-found success responses.
  - object
    - `success` boolean, required
    - `message` string, required
    - `code` integer, required
    - `data` unknown[]
      - unknown
    - `meta` object
      - `credits_used` integer
      - `remaining_credits` integer
      - `reason` 'EMPLOYEE_NOT_FOUND' | 'EMAIL_NOT_FOUND' | 'PHONE_NOT_FOUND' | 'COMPANY_NOT_FOUND': Present on empty/not-found success responses.

## Other responses

- `400`: Bad request — invalid parameter combination
- `401`: Missing, invalid, or inactive API key
- `402`: Insufficient credits
- `403`: Email verification on the fly is only available via GTM Unlimited.
- `422`: Validation failed
- `429`: Rate limit exceeded
- `500`: Upstream/search service error

---

[API](https://skmtc.dev/quickenrich/apis/quick-enrich-api.md) - [All operations](https://skmtc.dev/quickenrich/apis/quick-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/quickenrich/apis/quick-enrich-api/revisions/581bb7f6ae10?raw)