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

# Enrich employee (phone)

`GET /api/employees/phone-search`

## Request

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

Same lookup rules as /search. Returns phone fields (and limited identity/company fields). Consumes 1 credit when a phone is returned.

## Query parameters

- `linkedin_url` string, uri
- `company_url` string
- `first_name` string
- `last_name` string

## Response `200`

Phone found or not found (meta.reason PHONE_NOT_FOUND).

- object
  - `success` boolean, required
  - `message` string, required
  - `code` integer, required
  - `data` union
    - PhoneEnrichmentEmployee
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `company_name` string, nullable
      - `company_url` string, nullable
      - `employee_phone` string, nullable
      - `employee_phone_type` string, nullable
      - `employee_count` string
      - `address` string
      - `city` string
      - `region_code` string
      - `zip` string
      - `country_code` string
    - 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
- `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)