Authentication - PrimeFreight

curl -X POST https://api.primefreight.com/auth/tokens \
  -H "Content-Type: application/json" \
  -d '{"username":"YOUR_USERNAME","password":"YOUR_PASSWORD"}'

{
  "token": "<jwt>",
  "type": "Bearer",
  "expiresIn": "2h"
}

Obtain a token, then send it as a Bearer token on every request.

Obtain a token

POST /auth/tokens with your credentials returns a short-lived JWT.

curl -X POST https://api.primefreight.com/auth/tokens \
  -H "Content-Type: application/json" \
  -d '{"username":"YOUR_USERNAME","password":"YOUR_PASSWORD"}'

{
  "token": "<jwt>",
  "type": "Bearer",
  "expiresIn": "2h"
}

Call an endpoint

Send the token in the Authorization header.

curl https://api.primefreight.com/v2/shipments/shp_100001 \
  -H "Authorization: Bearer <token>"

Status codes

Code	Description
200	Request succeeded
401	Authentication failed — missing or invalid token
404	Resource not found
429	Rate limit exceeded