{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-pricing-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Response Status Codes"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"response-status-codes","__idx":0},"children":["Response Status Codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Echo receives a request to the EchoSync Pricing API, different HTTP status codes can be returned depending on the request and its processing."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"35%","data-label":"Status Code"},"children":["Status Code "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The request was successfully processed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The request cannot be processed due to validation errors. Invalid request format, enum values, stop sequences, missing required fields for partial mode, or date/postal code format errors. Check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}," array for specific validation failures."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication credentials are missing or invalid. The access token is expired, invalid, or not provided in the Authorization header. Request a new token using your client credentials."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 Forbidden"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Valid credentials provided but account lacks API access permissions. Contact your Echo Account Team to verify permissions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404 Not Found"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET only:"]}," The quote ID or quote key does not exist, has been deleted, or has expired."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422 Unprocessable Entity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST only:"]}," The request is valid but a quote could not be generated. No carriers available for the route, unserviceable postal codes, dates outside acceptable range, or equipment type unavailable. Verify postal codes, adjust dates (1-30 days typically works best), or try different equipment types."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500 Internal Server Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An internal error occurred in Echo's systems. Retry your request. If the issue persists, contact support with error codes and timestamps."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["502 Bad Gateway"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The server received an invalid response from upstream services. Typically requires a fix on Echo's systems. Check status and retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["503 Service Unavailable"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The server is temporarily unavailable. Service is down for maintenance or experiencing issues. Retry with exponential backoff."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-resolution-steps","__idx":1},"children":["Common Resolution Steps"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"400-bad-request-post","__idx":2},"children":["400 Bad Request (POST)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"invalid-enum-values","__idx":3},"children":["Invalid enum values"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify case-sensitive values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pick"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drop"]}," (stop.stopType)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"stop-sequence-errors","__idx":4},"children":["Stop sequence errors"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Number stops: 1, 2 (no gaps)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["First stop must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pick"]},", second stop must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drop"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"partial-mode-missing-requirements","__idx":5},"children":["Partial mode missing requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locationType"]}," to all stops"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["freight.handlingUnits"]}," with packages"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each package must have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["freightClass"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"datepostal-code-format","__idx":6},"children":["Date/postal code format"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Dates: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["yyyy-MM-dd"]}," format"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["US postal codes: 5 digits or 9 digits with hyphen"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Canadian postal codes: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A1A 1A1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A1A1A1"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"401-unauthorized","__idx":7},"children":["401 Unauthorized"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request new access token (10-hour lifetime)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify header: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer {token}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check credentials are correct"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"404-not-found-get","__idx":8},"children":["404 Not Found (GET)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify quote ID/key is correct"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check quote hasn't expired (Refer to expirationDate in response)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm using correct API version (V1 or V2)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"422-unprocessable-entity-post","__idx":9},"children":["422 Unprocessable Entity (POST)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate postal codes exist and are correctly formatted"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Try nearby major cities to test route serviceability"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adjust pickup dates (1-30 days out recommended)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Try different equipment types"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify account-level pricing rules are not preventing quote generation for the requested lane or equipment type with Echo account representative."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-response-format","__idx":10},"children":["Error Response Format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All error responses include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}," array with specific error messages:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}]}," - High-level error description"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]}," - Error code identifier"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["detail"]}]}," - General error context"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}]}," - Array of specific validation errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]}," - HTTP status code"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}," array provides actionable information to resolve validation issues."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Response Status Codes","id":"response-status-codes","depth":1},{"value":"Common Resolution Steps","id":"common-resolution-steps","depth":2},{"value":"400 Bad Request (POST)","id":"400-bad-request-post","depth":3},{"value":"Invalid enum values","id":"invalid-enum-values","depth":4},{"value":"Stop sequence errors","id":"stop-sequence-errors","depth":4},{"value":"Partial mode missing requirements","id":"partial-mode-missing-requirements","depth":4},{"value":"Date/postal code format","id":"datepostal-code-format","depth":4},{"value":"401 Unauthorized","id":"401-unauthorized","depth":3},{"value":"404 Not Found (GET)","id":"404-not-found-get","depth":3},{"value":"422 Unprocessable Entity (POST)","id":"422-unprocessable-entity-post","depth":3},{"value":"Error Response Format","id":"error-response-format","depth":2}],"frontmatter":{"id":"response-reference","title":"Response Reference Guide","seo":{"title":"Response Status Codes"}},"lastModified":"2026-10-22T19:54:40.555Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pricing-api/response-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}