Quickstart
From API key to your first page of loads in three steps.
The FR8 Factory Customer Data API gives your systems read-only access to your own load data — one endpoint, delta polling, page-number pagination.
1. Get an API key
Keys are issued by FR8 Factory operations — ask your account contact. You'll receive a key that looks like this:
fr8_live_3fK9…The key is shown to us exactly once at creation, so store it in your secret manager when you receive it. A key is scoped to your company: it can only ever return your own loads. Each key has a per-minute rate limit (default 10 — see Rate limits).
2. Make your first call
curl -H "Authorization: Bearer fr8_live_your_key_here" \
"https://www.fr8factory.com/api/v1/loads?pageSize=5"3. Read the response
{
"data": [
{
"loadNumber": "123456",
"poNumber": "PO-8801",
"billingRefNumber": "CLS-2214",
"originCity": "Boca Raton",
"originState": "FL",
"originZip": "33431",
"originWarehouse": "DC East",
"destinationCity": "Dallas",
"destinationState": "TX",
"destinationZip": "75201",
"destinationWarehouse": null,
"status": "InTransit",
"scheduledPickupDate": "2026-07-01T00:00:00.000Z",
"scheduledPickupTime": "08:00",
"scheduledDeliveryDate": "2026-07-03T00:00:00.000Z",
"scheduledDeliveryTime": "14:30",
"tenderedDate": "2026-06-28T15:00:00.000Z",
"actualPickupDate": "2026-07-01T08:12:00.000Z",
"actualDeliveryDate": null,
"requestedDeliveryDate": "2026-07-03T00:00:00.000Z",
"miles": "1112.4",
"totalCost": "2350.5",
"updatedAt": "2026-07-02T10:00:00.000Z"
}
],
"page": 1,
"pageSize": 5,
"totalCount": 1240,
"hasMore": true
}Every field is documented in the field dictionary. For syncing loads into your own system on a schedule, read delta polling and pagination — it covers the one caveat that matters.
Machine-readable contract
- OpenAPI 3.1:
/api/v1/openapi.json— point a client generator at it. - Postman collection: coming shortly — the share link will land here when it's published.
Getting help
Email your FR8 Factory account contact. Include the loadNumber and
the full request URL (never the key) when reporting a data question.