---
title: "Enrich a contact profile"
method: GET
path: "/v1/contacts/{contact_id}/enrich"
---

# Enrich a contact profile

`GET /v1/contacts/{contact_id}/enrich`

Returns verified emails, phone numbers, skills, full work history, education, and social profiles. Consumes 1 enrichment credit per new lookup (cached results are free). Returns HTTP 402 when credits are exhausted.

## Path parameters

- `contact_id` string, required

## Response `200`

Enriched contact profile

- EnrichedContact — Enriched contact profile with verified emails, phone numbers, work history, education, and social profiles. Consumes 1 enrichment credit per new lookup.
  - `id` string
  - `full_name` string
  - `first_name` string
  - `last_name` string
  - `sex` string
  - `job_title` string
  - `job_title_role` string
  - `job_title_levels` string[]
  - `job_company_name` string
  - `job_company_website` string
  - `job_company_size` string
  - `job_company_industry` string
  - `work_email` string, email, nullable
  - `personal_emails` string[]
  - `mobile_phone` string, nullable
  - `phone_numbers` string[]
  - `linkedin_url` string
  - `facebook_url` string, nullable
  - `location_name` string
  - `location_locality` string
  - `location_region` string
  - `location_country` string
  - `location_geo` string — Lat,lng coordinates
  - `skills` string[]
  - `experience` WorkExperience[]
    - `title` string
    - `company` string
    - `start_date` string
    - `end_date` string, nullable
    - `is_primary` boolean
  - `education` Education[]
    - `school` string
    - `start_date` string
    - `end_date` string, nullable
  - `profiles` object[]
    - `network` string
    - `url` string
  - `credits` object
    - `remaining` integer
    - `total` integer
    - `used` integer

## Other responses

- `401` — Invalid or missing API key
- `402` — Enrichment credits exhausted
- `404` — Carrier does not exist
- `429` — Too many requests. Check X-RateLimit-Remaining and Retry-After headers.

---

[API](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api.md) · [All operations](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runalphaloops/alphaloops-fmcsa-carrier-data-api/revisions/ae58c064a7af/schema)