latestOpenAPI 3.0.0Proprietary2026-08-22131410675.6 KB

8d8a7cf79204

rates

Get rate by ID

Retrieve a previously queried rate by its ID

get/v1/rates/{rate_id}

Response

The request was a success.

rate_request_idstring

A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.

shipment_idstring

A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.

created_atstring

A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.

status'working' | 'completed' | 'partial' | 'error'

The possible rate response status values

Example response

{
  "rates": [
    {
      "rate_id": "se-28529731",
      "carrier_id": "se-28529731",
      "rate_details": [
        {
          "carrier_description": "Shipping",
          "carrier_billing_code": "BaseServiceCharge",
          "billing_source": "carrier"
        }
      ],
      "zone": 6,
      "package_type": "package",
      "delivery_days": 5,
      "estimated_delivery_date": "2018-09-23T00:00:00.000Z"
    }
  ],
  "invalid_rates": [
    {
      "rate_id": "se-28529731",
      "carrier_id": "se-28529731",
      "rate_details": [
        {
          "carrier_description": "Shipping",
          "carrier_billing_code": "BaseServiceCharge",
          "billing_source": "carrier"
        }
      ],
      "zone": 6,
      "package_type": "package",
      "delivery_days": 5,
      "estimated_delivery_date": "2018-09-23T00:00:00.000Z"
    }
  ],
  "rate_request_id": "se-28529731",
  "shipment_id": "se-28529731",
  "created_at": "se-28529731",
  "errors": [
    {
      "message": "Body of request cannot be null.",
      "carrier_id": "se-28529731",
      "carrier_code": "dhl_express",
      "field_name": "shipment.ship_to.phone_number"
    }
  ]
}