Skip to main content
POST
/
rates
Get LTL rates
curl --request POST \
  --url https://api.shippeek.dev/rates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "originPostalCode": "<string>",
  "destPostalCode": "<string>",
  "items": [
    {
      "weight": 123,
      "freightClass": 50,
      "length": 123,
      "width": 123,
      "height": 123,
      "quantity": 1,
      "description": "<string>",
      "package": "<string>",
      "hazardous": false,
      "nmfc": "<string>"
    }
  ],
  "pickupDate": "2023-12-25",
  "charges": [
    "arrival notice"
  ],
  "originCompany": "<string>",
  "originAddress": "<string>",
  "originAddress2": "<string>",
  "originCity": "<string>",
  "originState": "<string>",
  "originCountry": "USA",
  "originType": "business dock",
  "destCompany": "<string>",
  "destAddress": "<string>",
  "destAddress2": "<string>",
  "destCity": "<string>",
  "destState": "<string>",
  "destCountry": "USA",
  "destType": "business dock"
}
'
{
  "id": "570665116d0bfce422911668",
  "rates": [
    {
      "id": "34575116d0afce4229116467",
      "status": "ok",
      "mode": "LTL",
      "paymentTerms": "Outbound Prepaid",
      "total": 123.45,
      "ref": "ABC123456",
      "days": 3,
      "serviceType": "Standard",
      "serviceDescription": "Standard",
      "time": 530,
      "carrierId": "84528496d0afce4229282716",
      "carrier": "Estes Express Lines",
      "carrierCode": "exla",
      "charges": [
        {
          "name": "linehaul",
          "amount": 1000
        },
        {
          "name": "discount",
          "amount": -900
        },
        {
          "name": "fuel",
          "amount": 23.45
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Your ShipPeek API token in the format client_id.client_secret.

Query Parameters

timeout
integer
default:30

How long to wait for rates (seconds). Use 1 to create a quote without waiting for all carriers.

Required range: 1 <= x <= 30
carriers
string[]

Comma-separated list of carrier SCAC codes to filter results.

Body

application/json
originPostalCode
string
required

Pickup ZIP code

destPostalCode
string
required

Delivery ZIP code

items
object[]
required

Items being shipped

pickupDate
string<date>

Requested pickup date (YYYY-MM-DD)

charges
enum<string>[]

Accessorial charges to include in the rate

Available options:
arrival notice,
arrival schedule,
liftgate pickup,
liftgate delivery,
inside pickup,
inside delivery,
sort and segregate,
protect from freezing
originCompany
string

Company name at pickup

originAddress
string

Street address at pickup

originAddress2
string
originCity
string
originState
string
originCountry
enum<string>
default:USA
Available options:
USA,
CAN
originType
enum<string>
default:business dock

Facility type at pickup location

Available options:
business dock,
business no dock,
residential,
limited access,
trade show,
construction,
farm,
military,
airport,
place of worship,
school,
mine,
pier
destCompany
string
destAddress
string
destAddress2
string
destCity
string
destState
string
destCountry
enum<string>
default:USA
Available options:
USA,
CAN
destType
enum<string>
default:business dock

Facility type at delivery location

Available options:
business dock,
business no dock,
residential,
limited access,
trade show,
construction,
farm,
military,
airport,
place of worship,
school,
mine,
pier

Response

Rates returned successfully

id
string

Quote ID for retrieving rates later

rates
object[]