Skip to main content
PATCH
/
v1
/
shipments
/
{id}
/
quote
Quote
curl --request PATCH \
  --url https://{defaultHost}/v1/shipments/{id}/quote \
  --header 'Authorization: Bearer <token>'
{
  "id": "09134ba9-35c8-4abe-97bd-b9c3ca9aa7a2",
  "object": "shipment",
  "status": "quoted",
  "live_mode": true,
  "label_url": null,
  "label_file_type": "PDF",
  "tracking_number": null,
  "tracking_url": null,
  "tracking_status": null,
  "eta": null,
  "weight": "2.0",
  "weight_unit": "lb",
  "carrier": null,
  "dimensions": {
    "length": 10,
    "width": 8,
    "height": 5,
    "unit": "in"
  },
  "rates": [
    {
      "id": "rate_1",
      "amount": "5.50",
      "currency": "USD",
      "provider": "USPS",
      "service_name": "Priority Mail",
      "estimated_days": 3
    },
    {
      "id": "rate_2",
      "amount": "12.00",
      "currency": "USD",
      "provider": "UPS",
      "service_name": "Ground",
      "estimated_days": 5
    }
  ],
  "selected_rate": null,
  "fulfillment": "ce6faedf-e311-4bd9-9835-36bc99cd93a0",
  "shipping_provider": "56124d3e-0e87-4741-b9af-3afc8aab4d10",
  "from_address": "5bd40899-4b22-4dba-83aa-4c1d5e84cecc",
  "to_address": "fe92a368-52b9-48e8-a7d2-c5fbd544f715",
  "parcel_template": null,
  "created_at": 1773748365,
  "updated_at": 1773748365
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Response

200 - application/json

Success

​
id
string | null

The UUID of the specific object.

​
object
string

A string describing the object type returned.

​
label_file_type
string

The file type for the shipping label – one of PDF, PDF_A4, PDF_A6, PDF_4x6, PDF_4x8, PNG, ZPLII.

​
parcel_template
string

Expandable – The associated parcel template ID.

​
weight
string | null

The weight of the parcel.

​
weight_unit
string | null

The unit of the weight.

​
inherit_weight
boolean

When true, inherit the weight from the fulfillment.

​
dimensions
object

The dimensions of the parcel.

​
status
string

The current status of this shipment – one of draft, quoted, purchased, voided.

​
live_mode
boolean

Whether or not this shipment was created in live mode.

​
label_url
string | null

The URL for the purchased shipping label.

​
tracking_number
string | null

The tracking number for this shipment.

​
tracking_url
string | null

The URL to track this shipment.

​
carrier
string | null

The shipping carrier for this shipment.

​
tracking_status
string | null

The current tracking status – one of unknown, pre_transit, in_transit, delivered, returned, failure.

​
eta
string | null

The estimated time of arrival.

​
rates
object[]

The available shipping rates for this shipment.

​
selected_rate
object

The selected shipping rate for this shipment.

​
fulfillment

Expandable – The associated fulfillment ID.

​
shipping_provider

Expandable – The associated shipping provider ID.

​
from_address

Expandable – The associated address ID.

​
to_address

Expandable – The associated address ID.

​
created_at
integer | null

Time at which the object was created. Measured in seconds since the Unix epoch.

​
updated_at
integer | null

Time at which the object was last updated. Measured in seconds since the Unix epoch.