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": "0f084681-d1d6-477b-ba22-3489fbc7e0a8",
  "object": "shipment",
  "carrier": null,
  "carrier_messages": [
    {
      "carrier": "Shippo",
      "messages": [
        "Carrier account shippo_sendle_account doesn't support one or more shipment options",
        "Carrier account shippo_correos_account doesn't support one or more shipment options",
        "Carrier account shippo_dpd_de_account doesn't support one or more shipment options",
        "Carrier account shippo_dpd_uk_account doesn't support one or more shipment options",
        "Carrier account shippo_colissimo_account doesn't support one or more shipment options",
        "Carrier account shippo_deutsche_post_account doesn't support one or more shipment options",
        "Carrier account shippo_canada_post_master doesn't support one or more shipment options",
        "Carrier account COURIERSPLEASE_SHIPPO_TIER_1 doesn't support one or more shipment options",
        "Carrier account shippo_chronopost_account doesn't support one or more shipment options",
        "Carrier account shippo_hermes_uk_account doesn't support one or more shipment options"
      ]
    },
    {
      "carrier": "UPS",
      "messages": [
        "Shipment origin is out of service area for UPS Master account from CA",
        "Hard: Too Many Requests"
      ]
    },
    {
      "carrier": "DHLExpress",
      "messages": [
        "Shippo's DHL Express master account doesn't support shipments to inside of the US"
      ]
    },
    {
      "carrier": "ShippoCommon",
      "messages": [
        "Shipment origin or destination state is out of the service area for LSO."
      ]
    }
  ],
  "contact_validations": {
    "from_contact": {
      "valid": false,
      "messages": []
    },
    "to_contact": {
      "valid": false,
      "messages": []
    }
  },
  "dimensions": {
    "length": 10,
    "width": 8,
    "height": 5,
    "unit": "in"
  },
  "eta": null,
  "inherit_weight": false,
  "label_file_type": "PDF",
  "label_url": null,
  "live_mode": true,
  "rates": [
    {
      "id": "20c81380f19143c2bc35e16dd34f2f5d",
      "amount": 644,
      "currency": "usd",
      "provider": "USPS",
      "service_name": "Ground Advantage",
      "estimated_days": 2,
      "tags": [
        "cheapest",
        "bestvalue"
      ],
      "duration_terms": "Delivery in 2 to 5 days.",
      "provider_logo_url": "https://shippo-static.s3.amazonaws.com/providers/75/USPS.png"
    },
    {
      "id": "e4456d3eac6d4297a28fa0e2bf3deeab",
      "amount": 3015,
      "currency": "usd",
      "provider": "USPS",
      "service_name": "Priority Mail Express",
      "estimated_days": 1,
      "tags": [
        "fastest"
      ],
      "duration_terms": "Overnight delivery to most U.S. locations.",
      "provider_logo_url": "https://shippo-static.s3.amazonaws.com/providers/75/USPS.png"
    },
    {
      "id": "ff4b976edda046ceb3250a07cc9fc763",
      "amount": 781,
      "currency": "usd",
      "provider": "USPS",
      "service_name": "Priority Mail",
      "estimated_days": 2,
      "tags": [],
      "duration_terms": "Delivery within 1, 2, or 3 days based on where your package started and where it’s being sent.",
      "provider_logo_url": "https://shippo-static.s3.amazonaws.com/providers/75/USPS.png"
    }
  ],
  "selected_rate": null,
  "shipping_date": 1776124800,
  "status": "quoted",
  "tracking_number": null,
  "tracking_status": null,
  "tracking_url": null,
  "weight": "2.0",
  "weight_unit": "lb",
  "from_contact": "9a248ce2-7455-4875-9874-531e060c7cac",
  "fulfillment": "b78d7529-e617-4a7c-840f-b7a4967d759c",
  "parcel_template": null,
  "shipping_provider": "1e576a7c-28ab-4efc-a38f-96bc06f541b1",
  "to_contact": "bf52e0d3-755d-4b7e-96e3-e02cc1a7c074",
  "created_at": 1776176579,
  "updated_at": 1776176579
}

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 – one of g, kg, lb, oz.

inherit_weight
boolean

When true, inherit the weight from the fulfillment.

shipping_date
integer

The date the shipment will be tendered to the carrier. Measured in seconds since the Unix epoch.

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.

carrier_messages
object[] | null

Messages from carriers about this shipment.

contact_validations
object

Contact validation results returned by the shipping provider. Only available after quoting.

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_contact

Expandable – The associated contact ID.

to_contact

Expandable – The associated contact 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.