--- title: "Get bulk rates" method: POST path: "/v2/rates/bulk" tags: ["rates"] --- # Get bulk rates `POST /v2/rates/bulk` Get Bulk Shipment Rates ## Request body - CompareBulkRatesRequestBody - `rate_options` RateRequestBody — A rate request body - `carrier_ids` SeId[], required — Array of carrier ids to get rates for - `package_types` string[] - `service_codes` string[] - `calculate_tax_amount` boolean — Calculate the duties and tariffs for cross border shipments. - `preferred_currency` string — The currencies that are supported by ShipStation are the ones that specified by ISO 4217: https://www.iso.org/iso-4217-currency-codes.html - `is_return` boolean — Indicate if it's a return shipment ## Response `200` The request was a success. - BulkRate[] — A bulk rate response body - `rate_request_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `shipment_id` string, required — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc. - `created_at` string, date-time, required — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time. - `status` 'working' | 'completed' | 'partial' | 'error', required — The possible rate response status values - `errors` Error[], required — An array of errors that were returned while retrieving the bulk rate - `error_source` 'carrier' | 'order_source' | 'ShipStation' | 'shipengine', required — The source of the error, as indicated by the name this informs us if the API call failed because of the carrier, the order source, the ShipStation API itself, or the underlying ShipEngine platform. - `error_type` 'account_status' | 'business_rules' | 'validation' | 'security' | 'system' | 'integrations', required — The type of error - `error_code` 'auto_fund_not_supported' | 'batch_cannot_be_modified' | 'carrier_conflict' | 'carrier_disconnected' | 'carrier_not_connected' | 'carrier_not_supported' | 'confirmation_not_supported' | 'default_warehouse_cannot_be_deleted' | 'field_conflict' | 'field_value_required' | 'forbidden' | 'identifier_conflict' | 'identifiers_must_match' | 'insufficient_funds' | 'invalid_address' | 'invalid_billing_plan' | 'invalid_field_value' | 'invalid_identifier' | 'invalid_status' | 'invalid_string_length' | 'label_images_not_supported' | 'meter_failure' | 'order_source_not_active' | 'rate_limit_exceeded' | 'refresh_not_supported' | 'request_body_required' | 'return_label_not_supported' | 'settings_not_supported' | 'subscription_inactive' | 'terms_not_accepted' | 'tracking_not_supported' | 'trial_expired' | 'unauthorized' | 'unknown' | 'unspecified' | 'verification_failure' | 'warehouse_conflict' | 'webhook_event_type_conflict' | 'customs_items_required' | 'incompatible_paired_labels' | 'invalid_charge_event' | 'invalid_object' | 'no_rates_returned' | 'freight_connection_inactive' | 'freight_provider_id_required' | 'freight_shipment_not_found' | 'freight_tracking_not_available' | 'freight_tracking_not_found' | 'freight_shipment_not_batchable', required — The error code specified for the failed API Call - `message` string, required — An error message associated with the failed API call - `field_name` string — The name of the field that caused the error (only present for validation errors) - `field_value` string — The invalid value that was provided for the field (only present for validation errors) ## Other responses - `400` — The request contained errors. - `500` — The request was successful. --- [API](https://skmtc.net/shipstation/apis/shipstation-api-v2.md) · [All operations](https://skmtc.net/shipstation/apis/shipstation-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipstation-api-v2/revisions/d3d8c21cd227/schema)