Rates

POST

/rates

Check service availability & ETA

Returns the available delivery service options for the given order details (Same-Day / Next-Day) and the expected pickup time and delivery date.

Pickup identification (required)

Provide one of the following:

externalLocationId (recommended), OR

postalCode

At least one of externalLocationId or postalCode must be included in the request.

How to interpret the response

serviceOptions contains one or more available services.

If serviceOptions is empty, the service is not available and a reason object is returned (e.g., OUT_OF_ZONE).

pickupToday is true when the order is before the cutoff hour (pickup happens today), otherwise false (pickup happens next day).

All timestamps are UTC unless otherwise specified.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠401

🟠400

Request Example

Shell

JavaScript

Java

Swift

cURL

Pickup uniqe IDPickup zip code requestZip code onlyFull pickup details

curl --location '/rates' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "pickup": {
        "externalLocationId": "LOC123467"
    },
    "shipTo": {
        "street1": "235 West 56th street",
        "city": "New York",
        "country": "United States",
        "postalCode": "10019"
    },
    "packages": [
        {
            "weight": 1.5
        },
        {
            "weight": 2
        }
    ]
}'

Response Example

200 - Same day service available

Valid if request was sent before same day cut off hour.

{
  "serviceOptions": [
    {
      "serviceType": "SAME_DAY",
      "pickupToday": true,
      "pickupTimeUtc": "2026-02-15T20:00:00Z",
      "estimatedDeliveryWindowUtc": {
        "start": "2026-02-15T18:00:00Z",
        "end": "2026-02-15T22:00:00Z"
      },
      "price": {
        "currency": "USD",
        "charge": 0,
        "note": "Contract pricing"
      }
    }
  ]
}

Create Bulk Orders

Rates

Check service availability & ETA#

Pickup identification (required)#

Request

Responses

Check service availability & ETA

Pickup identification (required)