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

# Enrich a contact profile

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

## Request

- Base URL: `https://api.runalphaloops.com`
- URL: `https://api.runalphaloops.com/v1/contacts/{contact_id}/enrich`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/docs/v1/contacts/:contact_id/enrich/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api.md) - [All operations](https://skmtc.dev/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/revisions/ae58c064a7af?raw)