Carriers
Carriers in a brokerage's network, with authority and insurance.
List carriers
GET/v1/carriers
Newest first, a page at a time. See Pagination and syncing.
curl "https://harlo-api-dev.pages.dev/v1/carriers?limit=10" \
-H "Authorization: Bearer $HARLO_API_KEY"Paging, order and format
| Parameter | What it does |
|---|---|
limit | How many to return, 1 to 100.Default: 25 |
cursor | `next_cursor` from the previous page. |
sort | Order: newest first by default.Values: -created_at, created_at, -updated_at, updated_atDefault: -created_at |
updated_since | Only records changed at or after this ISO 8601 time. |
created_since | Only records created at or after this ISO 8601 time. |
format | `csv` returns the page as a spreadsheet: nested fields become columns like `customer.name`.Values: json, csvDefault: json |
Retrieve a carrier
GET/v1/carriers/{id}
curl "https://harlo-api-dev.pages.dev/v1/carriers/09b8f960-d169-4869-a653-9ac42e6a3d11" \
-H "Authorization: Bearer $HARLO_API_KEY"Example response
{
"id": "09b8f960-d169-4869-a653-9ac42e6a3d11",
"object": "carrier",
"name": "Lakeshore Offer Test LLC",
"dba": null,
"usdot": "9990001",
"mc_number": "9990001",
"phone": "(312) 555-0188",
"email": "zbock+offer@goharlo.com",
"address": null,
"authority_status": "active",
"usdot_status": null,
"insurance": {
"auto_liability_expires_on": "2027-05-26",
"auto_liability_limit": 1000000,
"cargo_expires_on": "2027-05-26",
"cargo_limit": 100000
},
"do_not_use": false,
"created_at": "2026-11-12T22:29:05.745239+00:00",
"updated_at": "2026-11-13T13:28:43.97879+00:00"
}The carrier object
| Field | Type | What it is |
|---|---|---|
id | id | Unique id of the carrier. |
object | string | Always "carrier". |
name | string | |
dba | string, nullable | |
usdot | string, nullable | |
mc_number | string, nullable | |
phone | string, nullable | |
email | string, nullable | |
address | string, nullable | |
authority_status | string, nullable | |
usdot_status | string, nullable | |
insurance | object | |
auto_liability_expires_on | date, nullable | |
auto_liability_limit | number, nullable | |
cargo_expires_on | date, nullable | |
cargo_limit | number, nullable | |
do_not_use | boolean | |
created_at | timestamp, nullable | When it was created. |
updated_at | timestamp, nullable | When it last changed. Use with `updated_since` to sync. |