API Documentation

Introduction

The FreightAPIs API provides programmatic access to carrier location data for 10 carriers (ABF Freight, Central Transport, CEVA Logistics, C.H. Robinson, Estes Express, GLS US, Saia LTL, SEKO Logistics, TForce Freight and USPS), 4,400+ global seaports, Amazon drop point locations, and the National Motor Freight Classification (NMFC) database. All endpoints share a single, consistent REST interface.

Authentication

Authenticate by passing your API key in the Authorization header as a Bearer token.

You can generate and manage API keys from your dashboard after signing up. Each key is displayed only once at creation time - store it securely. The API also accepts the key in an X-API-Key header (used by the Postman collection and SDKs below).

curl https://freightapis.dev/api/article/63321 \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

API usage is metered per account against your plan's call allowance. There is no fixed per-second or concurrency limit — only the allowance below (we reserve the right to throttle abnormal traffic). When the allowance is exhausted the API returns 429 Too Many Requests.

When your allowance resets

Your allowance resets on your subscription billing cycle, not on the calendar month. It refreshes to a full allowance when a payment succeeds — your first subscription, each renewal, and paid upgrades. Changes that don't involve a charge (updating a card or invoice email, or downgrading, which produces only a prorated credit) do not refresh it; a downgrade takes effect on your next paid renewal. Accounts without an active subscription reset on the calendar month (UTC). Unused calls do not carry over.

Top-up balance

On paid plans, once the cycle's allowance is used up, calls are automatically drawn from any top-up pack balance on the account instead of failing — so you are only blocked with a 429 once both are exhausted. Top-up credits never expire and are not reset by renewals or plan changes.

Checking your usage

Current usage is shown on your account page. A 429 response body reports where you stand:

{
  "error": "Monthly API limit reached",
  "limit": 50000,
  "used": 50000,
  "topup_balance": 0,
  "upgrade_url": "https://freightapis.dev/pricing"
}

Error Codes

The API uses standard HTTP status codes. Error responses always include a JSON body with an error field containing a human-readable message.

{
  "error": "Invalid API key"
}

API Products

Choose a product to view its full endpoint reference.