How the Sparqle API reports failures and throttles requests.
The Sparqle API uses conventional HTTP status codes. 2xx means success, 4xx
means the request was rejected (usually something you can fix), and 5xx means
a problem on Sparqle’s side.
Status codes
Code
Meaning
200 / 201
Success.
400
Validation error — a field is missing, malformed, or out of range.
401
Missing or invalid API key.
403
The key isn’t allowed to act on this locationId or order.
404
The order, label, or resource doesn’t exist.
429
Too many requests — you’ve hit the rate limit.
500
Unexpected error on Sparqle’s side.
Validation errors
Request bodies are validated field by field. A 400 response lists what failed,
so you can surface the specific problem:
{ "statusCode": 400, "message": [ "deliveryName should not be empty", "deliveryAddress.postalCode should not be empty" ], "error": "Bad Request"}
Common causes:
Missing a required field (locationId)
Rate limits
Public tracking endpoints are throttled. If you exceed the limit you’ll get a
429 — back off and retry with exponential delay. If you expect sustained high
volume on the order endpoints, coordinate limits with your Sparqle contact.
Build retries with exponential backoff for 429 and 5xx responses, and
treat 4xx (except 429) as permanent — retrying won’t help until you fix the
request.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sparqle API","description":"Create deliveries, fetch labels, and track orders with the Sparqle API.","colors":{"primary":"#2C2A4C","light":"#94BFFF","dark":"#2C2A4C"},"logo":{"light":"https://mintcdn.com/sparqle/WNUWUpM65_OQ3roC/logo/surface.svg?fit=max\u0026auto=format\u0026n=WNUWUpM65_OQ3roC\u0026q=85\u0026s=1e0176396f723134028a362f094cc167","dark":"https://mintcdn.com/sparqle/WNUWUpM65_OQ3roC/logo/surface.svg?fit=max\u0026auto=format\u0026n=WNUWUpM65_OQ3roC\u0026q=85\u0026s=1e0176396f723134028a362f094cc167"},"favicon":"https://mintcdn.com/sparqle/WNUWUpM65_OQ3roC/logo/sparqle.png?fit=max\u0026auto=format\u0026n=WNUWUpM65_OQ3roC\u0026q=85\u0026s=fc316e24a85eb0df889780ae54fcc327","navbar":{"primary":{"type":"button","label":"Sparqle dashboard","href":"https://app.sparqle.com"}},"footer":{"socials":{"website":"https://www.sparqle.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sparqle","hasAudioNarration":false,"actualSubdomain":"sparqle","customDomains":["docs.sparqle.com"],"gitSource":{"type":"github","owner":"sparqletech","repo":"sparqle","deployBranch":"production","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aeddec7f99c6f493ac994a0","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Core concepts","count":8},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Coverage","count":3},{"language":"default","tag":"Labels","count":2},{"language":"default","tag":"Overview","count":1},{"language":"default","tag":"Guides","count":1},{"language":"default","tag":"Cancellation","count":1},{"language":"default","tag":"Orders","count":1}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"errors","slug":"/errors","pageMetadata":{"title":"Errors \u0026 rate limits","description":"How the Sparqle API reports failures and throttles requests.","href":"/errors"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How the Sparqle API reports failures and throttles requests.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Sparqle API uses conventional HTTP status codes. `,_jsx(_components.code,{children:`2xx`}),` means success, `,_jsx(_components.code,{children:`4xx`}),`\nmeans the request was rejected (usually something you can fix), and `,_jsx(_components.code,{children:`5xx`}),` means\na problem on Sparqle’s side.`]}),`\n`,_jsx(Heading,{level:`2`,id:`status-codes`,children:`Status codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{\"data-numeric\":`true`,children:[_jsx(_components.code,{children:`200`}),` / `,_jsx(_components.code,{children:`201`})]}),_jsx(_components.td,{children:`Success.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Validation error — a field is missing, malformed, or out of range.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Missing or invalid API key.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsxs(_components.td,{children:[`The key isn’t allowed to act on this `,_jsx(_components.code,{children:`locationId`}),` or order.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`The order, label, or resource doesn’t exist.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:`Too many requests — you’ve hit the rate limit.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:`Unexpected error on Sparqle’s side.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`validation-errors`,children:`Validation errors`}),`\n`,_jsxs(_components.p,{children:[`Request bodies are validated field by field. A `,_jsx(_components.code,{children:`400`}),` response lists what failed,\nso you can surface the specific problem:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"statusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"deliveryName should not be empty\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"deliveryAddress.postalCode should not be empty\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bad Request\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Common causes:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Missing a required field (`,_jsx(_components.code,{children:`locationId`}),`)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limits`,children:`Rate limits`}),`\n`,_jsxs(_components.p,{children:[`Public tracking endpoints are throttled. If you exceed the limit you’ll get a\n`,_jsx(_components.code,{children:`429`}),` — back off and retry with exponential delay. If you expect sustained high\nvolume on the order endpoints, coordinate limits with your Sparqle contact.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Build retries with exponential backoff for `,_jsx(_components.code,{children:`429`}),` and `,_jsx(_components.code,{children:`5xx`}),` responses, and\ntreat `,_jsx(_components.code,{children:`4xx`}),` (except `,_jsx(_components.code,{children:`429`}),`) as permanent — retrying won’t help until you fix the\nrequest.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Errors \u0026 rate limits","description":"How the Sparqle API reports failures and throttles requests.","href":"/errors"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Status codes","slug":"status-codes","depth":2,"children":[]},{"title":"Validation errors","slug":"validation-errors","depth":2,"children":[]},{"title":"Rate limits","slug":"rate-limits","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sparqle","siteName":"Sparqle API","title":"Errors \u0026 rate limits - Sparqle API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-20T14:02:36.395Z","originalFileLocation":"errors.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"How the Sparqle API reports failures and throttles requests.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sparqle API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Errors \u0026amp; rate limits - Sparqle API\">\u003cmeta data-mint-head property=\"og:description\" content=\"How the Sparqle API reports failures and throttles requests.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sparqle API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sparqle.com/errors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sparqle.mintlify.site/_mintlify/api/og/v2?division=Core+concepts\u0026amp;title=Errors+%26+rate+limits\u0026amp;description=How+the+Sparqle+API+reports+failures+and+throttles+requests.\u0026amp;theme=a1fc2de7fc95e7de4b27e6d9\u0026amp;signature=ffbfe68372294dcc6735050838689994151cbcb4bd71600fb461d50b299a04ae\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Errors \u0026amp; rate limits - Sparqle API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How the Sparqle API reports failures and throttles requests.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sparqle.mintlify.site/_mintlify/api/og/v2?division=Core+concepts\u0026amp;title=Errors+%26+rate+limits\u0026amp;description=How+the+Sparqle+API+reports+failures+and+throttles+requests.\u0026amp;theme=a1fc2de7fc95e7de4b27e6d9\u0026amp;signature=ffbfe68372294dcc6735050838689994151cbcb4bd71600fb461d50b299a04ae\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/sparqle/Zlh0X8kYdkhZR95b/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sparqle API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2C2A4C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sparqle.com/errors\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/errors.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sparqle.com/#organization\",\"name\":\"Sparqle API\",\"url\":\"https://docs.sparqle.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sparqle/WNUWUpM65_OQ3roC/logo/surface.svg?fit=max\u0026auto=format\u0026n=WNUWUpM65_OQ3roC\u0026q=85\u0026s=1e0176396f723134028a362f094cc167\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sparqle.com#website\",\"name\":\"Sparqle API\",\"url\":\"https://docs.sparqle.com\",\"publisher\":{\"@id\":\"https://docs.sparqle.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sparqle.com/errors#webpage\",\"url\":\"https://docs.sparqle.com/errors\",\"name\":\"Errors \u0026 rate limits\",\"description\":\"How the Sparqle API reports failures and throttles requests.\",\"dateModified\":\"2026-07-20T14:02:36.395Z\",\"isPartOf\":{\"@id\":\"https://docs.sparqle.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sparqle.com/errors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sparqle.com/errors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core concepts\",\"item\":\"https://docs.sparqle.com/concepts/order-lifecycle\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Errors \u0026 rate limits\",\"item\":\"https://docs.sparqle.com/errors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sparqle.com/errors#article\",\"headline\":\"Errors \u0026 rate limits\",\"name\":\"Errors \u0026 rate limits\",\"description\":\"How the Sparqle API reports failures and throttles requests.\",\"url\":\"https://docs.sparqle.com/errors\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sparqle.com/errors#webpage\"},\"dateModified\":\"2026-07-20T14:02:36.395Z\",\"publisher\":{\"@id\":\"https://docs.sparqle.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sparqle.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sparqle API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sparqle API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/errors.md","siteName":"Sparqle API","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"Sparqle API","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Environments","href":"/environments"}]},{"group":"Core concepts","pages":[{"title":"Order lifecycle","href":"/concepts/order-lifecycle"},{"title":"Routing \u0026 fallback","href":"/concepts/routing"},{"title":"Pickup points","href":"/concepts/pickup-points"},{"title":"Labels","href":"/concepts/labels"},{"title":"Order bundling","href":"/concepts/order-bundling"},{"title":"Multiple brands","href":"/concepts/multiple-brands"},{"title":"Webhooks","description":"Receive a POST to your endpoint whenever an order changes status.","href":"/webhooks"},{"title":"Errors \u0026 rate limits","href":"/errors"}]},{"group":"Guides","pages":[{"title":"Upload orders from a spreadsheet","description":"Create multiple orders from an Excel or CSV file in the Sparqle dashboard.","href":"/guides/manual-order-upload"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Errors \u0026 rate limits - Sparqle API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}