---
title: "Retrieve onboarded carrier contacts"
method: GET
path: "/onboarded-carrier/contacts"
tags: ["Onboarded Carriers"]
---

# Retrieve onboarded carrier contacts

`GET /onboarded-carrier/contacts`

Returns a paginated list of onboarded carrier contacts for the authenticated customer. Only contacts belonging to the customer identified in the JWT are returned. Requires the external-api-get-onboarded-carrier-contact permission.

## Query parameters

- `page` integer
- `page_size` integer
- `usdot_number` string

## Response `200`

Onboarded carrier contacts retrieved successfully.

- object
  - `contacts` object[] — List of onboarded carrier contacts.
    - `contact_id` string, uuid — Unique identifier of the onboarded carrier contact.
    - `dot_number` string — USDOT number associated with the carrier.
    - `customer_id` integer — Identifier of the customer that owns the contact.
    - `contact_name` string — Full name of the contact.
    - `contact_email` string — Email address of the contact.
    - `contact_phone` string — Phone number of the contact.
    - `contact_source` string — Source of the onboarded contact record.
  - `pagination` object — Pagination metadata.
    - `page_size` integer — Number of results per page.
    - `current_page` integer — Current page number.
    - `total_pages` integer — Total number of available pages.

## Other responses

- `400` — Bad Request – Invalid query parameters.
- `401` — Unauthorized – Invalid or missing authentication headers.
- `403` — Forbidden – User does not have required permission.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/genlogs/apis/auth-api-create-token.md) · [All operations](https://skmtc.net/genlogs/apis/auth-api-create-token/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genlogs/auth-api-create-token/versions/bf34c2431a21/schema)