{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/docs/direct-carrier-connections/rating/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#rating\" aria-label=\"rating permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"rating\"></div>Rating</h1>\n<p>Rating requests a price and transit-time quote directly from one or more connected carriers for a shipment.</p>\n<h2 style=\"position:relative;\"><a href=\"#how-it-works\" aria-label=\"how it works permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"how-it-works\"></div>How it works</h2>\n<p>Rating is asynchronous: you submit a rating request describing the shipment (origin, destination, weight, dimensions, accessorials, and so on) along with which connected carriers to request quotes from, and Shipwell returns a rating request ID immediately. Shipwell then reaches out to each requested carrier at the same time, so you don't wait on a slow carrier before hearing back from a fast one.</p>\n<p>A typical rating request follows these steps:</p>\n<ol>\n<li>\n<strong>Create a rating request</strong>\n — describe the shipment and the carriers to quote.\n</li>\n<li>\n<strong>Shipwell fans the request out</strong>\n to each carrier in parallel.\n</li>\n<li>\n<strong>Poll for status and rates</strong>\n — check the request until it reaches a completed state, then read the rates each carrier returned. Rates can also be streamed back as they arrive, rather than polled for.\n</li>\n<li>\n<strong>Compare and select a rate</strong>\n — each carrier's response is normalized into the same shape, so rates can be compared directly regardless of which carrier returned them, even though every carrier's own pricing API looks different behind the scenes.\n</li>\n</ol>\n<p>A rating request completes once all requested carriers have responded (or timed out); a carrier that doesn't respond in time simply won't have a rate in the results.</p>\n<p>Rates from your connected carriers appear alongside your other rates in the Shipwell application (for example, on a shipment's <strong>Rates</strong> tab), each showing the carrier, service, delivery date, transit time, and price:</p>\n<p><img src=\"/16b28dcfb7e2104018f162b08beceb05/rating-instant-rates.png\" alt=\"Instant Rates on a shipment&#x27;s Rates tab, showing rates returned from several directly connected carriers\"></p>\n<h2 style=\"position:relative;\"><a href=\"#endpoints\" aria-label=\"endpoints permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"endpoints\"></div>Endpoints</h2>\n<ul>\n<li>\nPOST \n<code class=\"language-text\">/rating</code>\n — create a rating request.\n</li>\n<li>\nGET \n<code class=\"language-text\">/rating/{rate_request_id}/status</code>\n — check the status of a rating request.\n</li>\n<li>\nGET \n<code class=\"language-text\">/rating/{rate_request_id}/rates</code>\n — get the rates returned so far or once complete.\n</li>\n<li>\nGET \n<code class=\"language-text\">/rating/{rate_request_id}/tasks/{rating_task_id}/rates</code>\n — get the rate(s) from one specific carrier within the request.\n</li>\n<li>\nPOST \n<code class=\"language-text\">/rating/quote</code>\n — a simpler, synchronous quote from a single carrier (legacy, still supported).\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#volume-ltl\" aria-label=\"volume ltl permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"volume-ltl\"></div>Volume LTL</h2>\n<p>Some carriers also support Volume LTL (VLTL) rating alongside standard LTL rating — useful for shipments too large for standard LTL pricing but not a full truckload. See <a href=\"/docs/direct-carrier-connections/supported-carriers/\">Supported Carriers</a> for which carriers offer VLTL.</p>\n<h2 style=\"position:relative;\"><a href=\"#api-reference\" aria-label=\"api reference permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"api-reference\"></div>API reference</h2>\n<p>Coming soon.</p>\n<h2 style=\"position:relative;\"><a href=\"#next-steps\" aria-label=\"next steps permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"next-steps\"></div>Next steps</h2>\n<p>Once you have a rate you want to move forward with, use it to <a href=\"/docs/direct-carrier-connections/dispatch/\">dispatch</a> the shipment to that carrier.</p>","headings":[{"value":"Rating","depth":1},{"value":"How it works","depth":2},{"value":"Endpoints","depth":2},{"value":"Volume LTL","depth":2},{"value":"API reference","depth":2},{"value":"Next steps","depth":2}]},"contentItem":{"data":{"lastModified":"2026-08-26T14:38:06.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":true,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"5f1cf2aa-1b4a-5a4a-9a75-c5c4115d3145__redocly content/docs/direct-carrier-connections/rating/","seo":{"title":"Rating","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"docs/direct-carrier-connections/rating.md","pageBaseUrl":"/docs/direct-carrier-connections/rating","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Rating","id":"rating"},{"depth":2,"value":"How it works","id":"how-it-works"},{"depth":2,"value":"Endpoints","id":"endpoints"},{"depth":2,"value":"Volume LTL","id":"volume-ltl"},{"depth":2,"value":"API reference","id":"api-reference"},{"depth":2,"value":"Next steps","id":"next-steps"}]},"data":{"title":"Rating"},"catalogInfo":null,"link":"/docs/direct-carrier-connections/rating/","sidebarName":"developerPortal","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}