--- title: "Retrieve shipment rates" method: GET path: "/shipments/{ShipmentId}/rates" tags: ["Rates"] --- # Retrieve shipment rates `GET /shipments/{ShipmentId}/rates` Returns a paginated list of rates associated with a shipment. Rates for shipments older than 390 days are not returned. ## Path parameters - `ShipmentId` string, required ## Query parameters - `page` integer - `results` integer ## Headers - `SHIPPO-API-VERSION` string ## Response `200` Paginated list of rates - RatePaginatedList - `next` string - `previous` string - `results` Rate[] - `amount` string, required — Final Rate price, expressed in the currency used in the sender's country. - `amount_local` string, required — Final Rate price, expressed in the currency used in the recipient's country. - `currency` string, required — Currency used in the sender's country, refers to `amount`. The [official ISO 4217](http://www.xe.com/iso4217.php) currency codes are used, e.g. `USD` or `EUR`. - `currency_local` string, required — Currency used in the recipient's country, refers to `amount_local`. The [official ISO 4217](http://www.xe.com/iso4217.php) currency codes are used, e.g. `USD` or "EUR". - `arrives_by` string — Predicted time the carrier will deliver the package in the destination's local time zone. In the format `HH:MM:SS`. - `attributes` string[], required — An array containing specific attributes of this Rate in context of the entire shipment. Attributes can be assigned `CHEAPEST`, `FASTEST`, or `BESTVALUE`. - `carrier_account` string, required — Object ID of the carrier account that has been used to retrieve the rate. - `duration_terms` string — Further clarification of the transit times. Often, this includes notes that the transit time as given in "days" is only an average, not a guaranteed time. - `estimated_days` integer — Estimated transit time (duration) in days of the Parcel at the given servicelevel. Please note that this is not binding, but only an average value as given by the provider. Shippo is not able to guarantee any transit times. - `included_insurance_price` string — Cost to the user to insure the Rate for the requested amount of coverage, if insurance coverage was requested. Expressed in the currency used in the sender's country. Will be null if no insurance coverage was requested, or if insurance is requested from a non-standard insurance provider. Please note this price is already included in the `amount` and `amount_local` fields on the Rate. Do not add this field to them. - `messages` ResponseMessage[] - `source` string — Origin of message - `code` string — Classification of message - `text` string — Message content - `object_created` string, date-time, required — Date and time of Rate creation. - `object_id` string, required — Unique identifier of the given Rate object. - `object_owner` string, required — Username of the user who created the rate object. - `provider` string, required — Carrier offering the rate, e.g., `FedEx` or `Deutsche Post DHL`. - `provider_image_75` string — URL to the provider logo with max. dimensions of 75*75px. Please refer to the provider's Logo Usage Guidelines before using the logo. - `provider_image_200` string — URL to the provider logo with max. dimensions of 200*200px. Please refer to the provider's Logo Usage Guidelines before using the logo. - `servicelevel` ServiceLevelWithParent, required — Contains details regarding the service level for the given rate. - `name` string — Name of the Rate's servicelevel, e.g. `International Priority` or `Standard Post`. A servicelevel commonly defines the transit time of a Shipment (e.g., Express vs. Standard), along with other properties. These names vary depending on the provider. - `terms` string — Further clarification of the service. - `token` string — Token of the Rate's servicelevel, e.g. `usps_priority` or `fedex_ground`. See [servicelevels](/shippoapi/public-api/service-levels). - `extended_token` string — Unique, extended version of the Service Level "token". Guaranteed to be unique across all Service Levels, and may help offer insight into the specific Service Level it describes. - `parent_servicelevel` object — Used for some Service Levels to link to the more "generic" version of this Service Level - for example, if this Service Level is a variation specific to shipments to Europe("ups_saver_eu"), the "parent" is the fully generic version ("ups_saver"). Helpful when displaying Service Levels to users. Has the same structure of the servicelevel - "name", "token", "terms", and "extended_token", or it is otherwise null. - `name` string — Name of the Rate's servicelevel, e.g. `International Priority` or `Standard Post`. A servicelevel commonly defines the transit time of a Shipment (e.g., Express vs. Standard), along with other properties. These names vary depending on the provider. - `terms` string — Further clarification of the service. - `token` string — Token of the Rate's servicelevel, e.g. `usps_priority` or `fedex_ground`. See [servicelevels](/shippoapi/public-api/service-levels). - `extended_token` string — Unique, extended version of the Service Level "token". Guaranteed to be unique across all Service Levels, and may help offer insight into the specific Service Level it describes. - `shipment` string, required - `test` boolean — Indicates whether the object has been created in test mode. - `zone` string — The parcel's transit zone token. These tokens can vary depending on the provider. ## Other responses - `400` — Bad request --- [API](https://skmtc.net/goshippo/apis/shippo-address-api.md) · [All operations](https://skmtc.net/goshippo/apis/shippo-address-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goshippo/shippo-address-api/versions/26fcc6af452a/schema)