The error envelope shape and what each error code means
Every failed request returns the same envelope shape, an HTTP status code that matches the failure, plus a JSON body:
{ "success": false, "error": { "code": "validation_error", "message": "Some fields need attention.", "fields": { "qty": "must be greater than 0" } }}
fields is only present when code is validation_error, it’s a map of field name to a plain-English problem description.
Error codes
Code
What it means
invalid_request
The request itself is malformed, bad JSON, missing required structure.
unauthorized
Your API key is missing, malformed, unknown, revoked, or expired. See Authentication, all of these return the same generic message on purpose.
not_found
The resource doesn’t exist, or belongs to a different organization than your key’s (from your key’s perspective, those look identical).
validation_error
One or more fields failed validation. Check the fields object for specifics.
conflict
Something you’re creating collides with something that already exists, for example, reusing an invoice no that’s already in use in your organization.
rate_limited
You’ve hit the per-resource rate limit. See Rate Limits.
method_not_allowed
You used an HTTP method the endpoint doesn’t support.
server_error
Something went wrong on Billbooks’ side. If this persists, get in touch.
Since not_found covers both “doesn’t exist” and “belongs to someone else,” you can’t use it to probe whether a given ID exists in another organization, both cases look the same from the outside.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Billbooks Developers","colors":{"primary":"#114a4d","light":"#5eead4","dark":"#114a4d"},"logo":{"light":"https://mintcdn.com/billbooks/jXmJmhNHvMwPE891/logo/light.svg?fit=max\u0026auto=format\u0026n=jXmJmhNHvMwPE891\u0026q=85\u0026s=881e2364171dc06515500a6ca77a20ef","dark":"https://mintcdn.com/billbooks/jXmJmhNHvMwPE891/logo/dark.svg?fit=max\u0026auto=format\u0026n=jXmJmhNHvMwPE891\u0026q=85\u0026s=6f532cce98c5bd0e5f7de9d81bb43305"},"favicon":"https://mintcdn.com/billbooks/jXmJmhNHvMwPE891/favicon.png?fit=max\u0026auto=format\u0026n=jXmJmhNHvMwPE891\u0026q=85\u0026s=45d8929f4ce18cdd11cccdb067a90465","navbar":{"links":[{"href":"https://www.billbooks.com","label":"Billbooks.com"}],"primary":{"type":"button","label":"Start free trial","href":"https://app.billbooks.com/sign-up"}},"footer":{"socials":{}},"search":{"prompt":"Search the Billbooks developer docs"},"fonts":{"family":"IBM Plex Sans"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"billbooks","hasAudioNarration":false,"actualSubdomain":"billbooks","customDomains":["docs.billbooks.com"],"gitSource":{"type":"github","owner":"billbooks-pty-ltd","repo":"billbooks-developer-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a8d23cfac857e7e139f16c6","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"How-to guides","count":5},{"language":"default","tag":"API Reference","count":1},{"language":"default","tag":"Overview","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":true},"customCss":[]}
{"page":{"pagePath":"errors","slug":"/errors","pageMetadata":{"title":"Errors","description":"The error envelope shape and what each error code means","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: \"The error envelope shape and what each error code means\"\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={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._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:[_jsx(_components.p,{children:`Every failed request returns the same envelope shape, an HTTP status code that matches the failure, plus a JSON body:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,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:`10`,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:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"validation_error\"`}),_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:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Some fields need attention.\"`}),_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:` \"fields\"`}),_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:` \"qty\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"must be greater than 0\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`fields`}),` is only present when `,_jsx(_components.code,{children:`code`}),` is `,_jsx(_components.code,{children:`validation_error`}),`, it’s a map of field name to a plain-English problem description.`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_request`})}),_jsx(_components.td,{children:`The request itself is malformed, bad JSON, missing required structure.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unauthorized`})}),_jsxs(_components.td,{children:[`Your API key is missing, malformed, unknown, revoked, or expired. See `,_jsx(_components.a,{href:`/authentication`,children:`Authentication`}),`, all of these return the same generic message on purpose.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`not_found`})}),_jsx(_components.td,{children:`The resource doesn’t exist, or belongs to a different organization than your key’s (from your key’s perspective, those look identical).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`validation_error`})}),_jsxs(_components.td,{children:[`One or more fields failed validation. Check the `,_jsx(_components.code,{children:`fields`}),` object for specifics.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`conflict`})}),_jsxs(_components.td,{children:[`Something you’re creating collides with something that already exists, for example, reusing an invoice `,_jsx(_components.code,{children:`no`}),` that’s already in use in your organization.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rate_limited`})}),_jsxs(_components.td,{children:[`You’ve hit the per-resource rate limit. See `,_jsx(_components.a,{href:`/rate-limits`,children:`Rate Limits`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`method_not_allowed`})}),_jsx(_components.td,{children:`You used an HTTP method the endpoint doesn’t support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`server_error`})}),_jsx(_components.td,{children:`Something went wrong on Billbooks’ side. If this persists, get in touch.`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Since `,_jsx(_components.code,{children:`not_found`}),` covers both “doesn’t exist” and “belongs to someone else,” you can’t use it to probe whether a given ID exists in another organization, both cases look the same from the outside.`]})})]})}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","description":"The error envelope shape and what each error code means","href":"/errors"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Error codes","slug":"error-codes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"billbooks","siteName":"Billbooks Developers","title":"Errors - Billbooks Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-18T03:23:57.919Z","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=\"The error envelope shape and what each error code means\">\u003cmeta data-mint-head name=\"application-name\" content=\"Billbooks Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/billbooks/DtRNEGtcBglxM7tA/_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/billbooks/DtRNEGtcBglxM7tA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/billbooks/DtRNEGtcBglxM7tA/_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/billbooks/DtRNEGtcBglxM7tA/_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/billbooks/DtRNEGtcBglxM7tA/_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/billbooks/DtRNEGtcBglxM7tA/_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/billbooks/DtRNEGtcBglxM7tA/_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/billbooks/DtRNEGtcBglxM7tA/_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/billbooks/DtRNEGtcBglxM7tA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Errors - Billbooks Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"The error envelope shape and what each error code means\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Billbooks Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.billbooks.com/errors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://billbooks.mintlify.site/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=Errors\u0026amp;description=The+error+envelope+shape+and+what+each+error+code+means\u0026amp;theme=561a283edf63db09ec1b52d8\u0026amp;signature=cc3c5dc478c66202afeba73c63d2a56911a32afbfdad6f8e1b1a560756a91829\">\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 - Billbooks Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The error envelope shape and what each error code means\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://billbooks.mintlify.site/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=Errors\u0026amp;description=The+error+envelope+shape+and+what+each+error+code+means\u0026amp;theme=561a283edf63db09ec1b52d8\u0026amp;signature=cc3c5dc478c66202afeba73c63d2a56911a32afbfdad6f8e1b1a560756a91829\">\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/billbooks/DtRNEGtcBglxM7tA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Billbooks Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#114a4d\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.billbooks.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.billbooks.com/#organization\",\"name\":\"Billbooks Developers\",\"url\":\"https://docs.billbooks.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/billbooks/jXmJmhNHvMwPE891/logo/light.svg?fit=max\u0026auto=format\u0026n=jXmJmhNHvMwPE891\u0026q=85\u0026s=881e2364171dc06515500a6ca77a20ef\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.billbooks.com#website\",\"name\":\"Billbooks Developers\",\"url\":\"https://docs.billbooks.com\",\"publisher\":{\"@id\":\"https://docs.billbooks.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.billbooks.com/errors#webpage\",\"url\":\"https://docs.billbooks.com/errors\",\"name\":\"Errors\",\"description\":\"The error envelope shape and what each error code means\",\"dateModified\":\"2026-08-18T03:23:57.919Z\",\"isPartOf\":{\"@id\":\"https://docs.billbooks.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.billbooks.com/errors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.billbooks.com/errors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get Started\",\"item\":\"https://docs.billbooks.com/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Errors\",\"item\":\"https://docs.billbooks.com/errors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.billbooks.com/errors#article\",\"headline\":\"Errors\",\"name\":\"Errors\",\"description\":\"The error envelope shape and what each error code means\",\"url\":\"https://docs.billbooks.com/errors\",\"mainEntityOfPage\":{\"@id\":\"https://docs.billbooks.com/errors#webpage\"},\"dateModified\":\"2026-08-18T03:23:57.919Z\",\"publisher\":{\"@id\":\"https://docs.billbooks.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.billbooks.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Billbooks Developers\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Billbooks Developers\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/errors.md","siteName":"Billbooks Developers","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Authentication","href":"/authentication"},{"title":"Quickstart","href":"/quickstart"},{"title":"Rate Limits","description":"How rate limiting works on this API, and its real limitations","href":"/rate-limits"},{"title":"Errors","href":"/errors"}]},{"group":"How-to guides","pages":[{"title":"Create and send an invoice","description":"The full invoice lifecycle: creating, editing, and the side effects that come with each","href":"/guides/create-and-send-an-invoice"},{"title":"Manage your client list","href":"/guides/manage-your-client-list"},{"title":"Build your item catalog","href":"/guides/build-your-item-catalog"},{"title":"Log expenses via API","href":"/guides/log-expenses-via-api"},{"title":"Create and manage estimates","href":"/guides/create-and-manage-estimates"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/overview"}]}]},"basePath":"","title":"Errors - Billbooks Developers","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}