---
title: "Match a company to a carrier by name"
method: GET
path: "/v1/carriers/search"
---

# Match a company to a carrier by name

`GET /v1/carriers/search`

Match a company to a carrier by name, domain, state, and city. Returns ranked results with a confidence score. At minimum, company_name is required.

## Query parameters

- `company_name` string, required
- `domain` string
- `state` string
- `city` string
- `page` integer
- `limit` integer

## Response `200`

Paginated search results with confidence scores

- CarrierSearchResponse
  - `total_results` integer
  - `results` CarrierSearchResult[]
    - `dot_number` string
    - `legal_name` string
    - `dba_name` string, nullable
    - `physical_city` string
    - `physical_state` string
    - `confidence` number — Match confidence score 0.0–1.0
  - `pagination` Pagination
    - `page` integer
    - `limit` integer
    - `total_results` integer
    - `total_pages` integer

## Other responses

- `400` — Invalid parameters
- `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)