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.

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

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

cURL

Pickup uniqe IDPickup zip code requestRecipient zip code only

curl --location --request POST '/rates' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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

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"
      }
    }
  ]
}

Shipments Count

Rates

Check service availability & ETA#

Request

Responses

Check service availability & ETA