---
title: "Find people at a carrier company"
method: GET
path: "/v1/contacts/search"
---

# Find people at a carrier company

`GET /v1/contacts/search`

Returns professional profiles including name, title, seniority, social profiles, and industry. Use dot_number or company_name to search. Note: This endpoint may return HTTP 202 with a Retry-After header if contacts are still being fetched — retry after the specified delay.

## Query parameters

- `dot_number` string
- `company_name` string
- `job_title` string
- `job_title_levels` 'vp' | 'director' | 'manager' | 'c_suite'
- `page` integer
- `limit` integer

## Response `200`

Paginated contact results

- ContactSearchResponse
  - `dot_number` string
  - `total_contacts` integer
  - `contacts` Contact[]
    - `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
    - `job_start_date` string
    - `industry` string
    - `linkedin_url` string
    - `facebook_url` string, nullable
    - `location_name` string
    - `location_region` string
    - `location_country` string
  - `pagination` Pagination
    - `page` integer
    - `limit` integer
    - `total_results` integer
    - `total_pages` integer

## Other responses

- `202` — Contacts are being fetched asynchronously. Retry after the delay specified in the Retry-After header.
- `401` — Invalid or missing API key
- `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/versions/dcfdb73e5778/schema)