{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/rates/multiple-shipments","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/rates/multiple-shipments","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/rates/multiple-shipments","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Rate Multiple Shipments","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"rate-multiple-shipments","__idx":0},"children":["Rate Multiple Shipments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can request rates for shipments in bulk using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/v1/rates/bulk"]}," endpoint. Unlike"," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/rates/get-shipment-rates"},"children":["Get Shipping Rates"]}," method, this process is asynchronous."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you subscribe to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/guides/webhooks"},"children":["webhooks"]},", you will receive a notification when the operation is complete. You can then ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/rates/get-shipment-rates"},"children":["retrieve the rates"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-from-rate"},"children":["create a label"]}," using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rate_id"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need to just rate a single shipment, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/rates/rates"},"children":["Calculate Shipping Rates page"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-requests","__idx":1},"children":["Example Requests"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/rates/bulk"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this sample, we request rates for shipments that were previously created by passing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_ids"]}," property."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/rates/bulk HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipment_ids\": [\n    \"se-2127226\",\n    \"se-2127227\"\n  ],\n  \"rate_options\": {\n    \"carrier_ids\": [\n      \"se-123890\",\n      \"se-121861\"\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alternatively, you can include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment"]}," object in the rate request rather than referencing an existing shipment. In this case, a shipment will be created for you and include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_id"]}," with each rate."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/rates/bulk HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"rate_options\": {\n    \"carrier_ids\": [\n      \"se-123890\",\n      \"se-123890\"\n    ]\n  },\n  \"shipments\": [{\n      \"ship_to\": {\n        \"name\": \"Amanda Miller\",\n        \"phone\": \"555-555-5555\",\n        \"address_line1\": \"525 S Winchester Blvd\",\n        \"city_locality\": \"San Jose\",\n        \"state_province\": \"CA\",\n        \"postal_code\": \"95128\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"yes\"\n      },\n      \"ship_from\": {\n        \"company_name\": \"Example Corp.\",\n        \"name\": \"John Doe\",\n        \"phone\": \"111-111-1111\",\n        \"address_line1\": \"4009 Marathon Blvd\",\n        \"address_line2\": \"Suite 300\",\n        \"city_locality\": \"Austin\",\n        \"state_province\": \"TX\",\n        \"postal_code\": \"78756\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"no\"\n      },\n      \"confirmation\": \"none\",\n      \"packages\": [{\n        \"package_code\": \"package\",\n        \"weight\": {\n          \"value\": 12,\n          \"unit\": \"ounce\"\n        }\n      }]\n    },\n    {\n      \"ship_to\": {\n        \"name\": \"Amanda Miller\",\n        \"phone\": \"555-555-5555\",\n        \"address_line1\": \"525 S Winchester Blvd\",\n        \"city_locality\": \"San Jose\",\n        \"state_province\": \"CA\",\n        \"postal_code\": \"95128\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"yes\"\n      },\n      \"ship_from\": {\n        \"company_name\": \"Example Corp.\",\n        \"name\": \"John Doe\",\n        \"phone\": \"111-111-1111\",\n        \"address_line1\": \"4009 Marathon Blvd\",\n        \"address_line2\": \"Suite 300\",\n        \"city_locality\": \"Austin\",\n        \"state_province\": \"TX\",\n        \"postal_code\": \"78756\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"no\"\n      },\n      \"confirmation\": \"none\",\n      \"packages\": [{\n        \"package_code\": \"package\",\n        \"weight\": {\n          \"value\": 1,\n          \"unit\": \"pound\"\n        }\n      }]\n    },\n    {\n      \"ship_to\": {\n        \"name\": \"Waffle HQ\",\n        \"company_name\": \"Waffle House\",\n        \"address_line1\": \"5986 Financial Drive\",\n        \"address_line2\": null,\n        \"address_line3\": null,\n        \"city_locality\": \"Norcross\",\n        \"state_province\": \"GA\",\n        \"postal_code\": \"30071\",\n        \"country_code\": \"US\",\n        \"phone\": \"111-111-1111\"\n      },\n      \"ship_from\": {\n        \"company_name\": \"Example Corp.\",\n        \"name\": \"John Doe\",\n        \"phone\": \"111-111-1111\",\n        \"address_line1\": \"4009 Marathon Blvd\",\n        \"address_line2\": \"Suite 300\",\n        \"city_locality\": \"Austin\",\n        \"state_province\": \"TX\",\n        \"postal_code\": \"78756\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"no\"\n      },\n      \"confirmation\": \"none\",\n      \"packages\": [{\n        \"package_code\": \"package\",\n        \"weight\": {\n          \"value\": 1,\n          \"unit\": \"ounce\"\n        }\n      }]\n    },\n    {\n      \"ship_to\": {\n        \"name\": \"Jony Ive\",\n        \"company_name\": \"Apple\",\n        \"address_line1\": \"1 Infinite Loop\",\n        \"address_line2\": null,\n        \"address_line3\": null,\n        \"city_locality\": \"Cupertino\",\n        \"state_province\": \"CA\",\n        \"postal_code\": \"95014\",\n        \"country_code\": \"US\",\n        \"phone\": \"408-996-1010\"\n      },\n      \"ship_from\": {\n        \"company_name\": \"Example Corp.\",\n        \"name\": \"John Doe\",\n        \"phone\": \"111-111-1111\",\n        \"address_line1\": \"4009 Marathon Blvd\",\n        \"address_line2\": \"Suite 300\",\n        \"city_locality\": \"Austin\",\n        \"state_province\": \"TX\",\n        \"postal_code\": \"78756\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"no\"\n      },\n      \"confirmation\": \"none\",\n      \"packages\": [{\n        \"package_code\": \"package\",\n        \"weight\": {\n          \"value\": 1,\n          \"unit\": \"ounce\"\n        }\n      }]\n    },\n    {\n      \"ship_to\": {\n        \"name\": \"Amanda Miller\",\n        \"phone\": \"555-555-5555\",\n        \"address_line1\": \"525 S Winchester Blvd\",\n        \"city_locality\": \"San Jose\",\n        \"state_province\": \"CA\",\n        \"postal_code\": \"95128\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"yes\"\n      },\n      \"ship_from\": {\n        \"company_name\": \"Example Corp.\",\n        \"name\": \"John Doe\",\n        \"phone\": \"111-111-1111\",\n        \"address_line1\": \"4009 Marathon Blvd\",\n        \"address_line2\": \"Suite 300\",\n        \"city_locality\": \"Austin\",\n        \"state_province\": \"TX\",\n        \"postal_code\": \"78756\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"no\"\n      },\n      \"confirmation\": \"none\",\n      \"packages\": [{\n        \"package_code\": \"package\",\n        \"weight\": {\n          \"value\": 1,\n          \"unit\": \"ounce\"\n        }\n      }]\n    }\n  ]\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-response","__idx":2},"children":["Example Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Due to the length of the response, we have truncated this example to only show a single rate. When you run this command, you will notice many more rates returned in the response."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"rate_request_id\": 501846,\n    \"shipment_id\": \"se-2127226\",\n    \"status\": \"working\",\n    \"created_at\": \"2019-07-25T15:24:46.657Z\"\n  },\n  {\n    \"rate_request_id\": 501847,\n    \"shipment_id\": \"se-2127227\",\n    \"status\": \"working\",\n    \"created_at\": \"2019-07-25T15:24:46.657Z\"\n  }\n]\n","lang":"json"},"children":[]}]},"headings":[{"value":"Rate Multiple Shipments","id":"rate-multiple-shipments","depth":1},{"value":"Example Requests","id":"example-requests","depth":2},{"value":"Example Response","id":"example-response","depth":2}],"frontmatter":{"seo":{"title":"Rate Multiple Shipments"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/rates/multiple-shipments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}