Recording expenses, how invoice-linking works, and a gap you should know about
Expenses can stand alone (just a record of money spent) or get linked to an invoice so a client is billed for them. That link is one-directional and system-managed, and there’s a real gap in how deletion is guarded that’s worth reading before you build against this endpoint.
Don’t send is_invoiced or invoice_id on create, even set to false or 0. Submitting either field at all rejects the entire request with 422. Those two fields are system-managed and only ever get set by the Invoices endpoint’s own linking logic, when a line item on an invoice bills this expense.
How invoice-linking actually happens
There’s no “link this expense to that invoice” call on the Expenses endpoint. The link is created from the other direction: when you create or edit an invoice and include a line item with an expense_id, that’s what sets the expense’s is_invoiced and invoice_id fields. See Create and send an invoice for the invoice side of this.If you edit that invoice later and remove the line referencing the expense (remember, items is a full replace on invoice PUT), the link is reversed as part of that edit.
Available filters: vendor, category_id, client_id, project_id, datestart/dateend (date range), currency, and free-text q. filter[status] accepts pass-through pseudo-filters like unbilled, invoiced, billable, non-billable, withreceipts, withoutreceipts, and recurring, not independently re-validated by this endpoint, they’re whatever the underlying expense model accepts.
This is a real gap, not a documented design choice: deleting an expense has no guard rail at all, unlike Clients or Items, which block deletion when the record is already in use. An expense that’s already linked to an invoice (is_invoiced is true) can be deleted outright through this endpoint. Doing so orphans the invoice line item that references it, the invoice keeps the line, but the expense record behind it is gone.
If your integration deletes expenses programmatically, check is_invoiced yourself first and treat a true value as a reason to hold off, the API won’t stop you.
{"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.4177","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":"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"guides/log-expenses-via-api","slug":"/guides/log-expenses-via-api","pageMetadata":{"title":"Log expenses via API","description":"Recording expenses, how invoice-linking works, and a gap you should know about","href":"/guides/log-expenses-via-api"},"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: \"Recording expenses, how invoice-linking works, and a gap you should know about\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Expenses can stand alone (just a record of money spent) or get linked to an invoice so a client is billed for them. That link is one-directional and system-managed, and there’s a real gap in how deletion is guarded that’s worth reading before you build against this endpoint.`}),`\n`,_jsx(Heading,{level:`2`,id:`create-an-expense`,children:`Create an expense`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://app.billbooks.com/api/public-api/v1/expenses`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer bb_live_your_key_here\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"date\": \"2026-08-18\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 84.50,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"vendor\": \"Adobe\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"category_id\": 6,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"client_id\": 4821,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"billable\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"currency\": \"USD\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Don’t send `,_jsx(_components.code,{children:`is_invoiced`}),` or `,_jsx(_components.code,{children:`invoice_id`}),` on create, even set to `,_jsx(_components.code,{children:`false`}),` or `,_jsx(_components.code,{children:`0`}),`. Submitting either field at all rejects the entire request with `,_jsx(_components.code,{children:`422`}),`. Those two fields are system-managed and only ever get set by the Invoices endpoint’s own linking logic, when a line item on an invoice bills this expense.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`how-invoice-linking-actually-happens`,children:`How invoice-linking actually happens`}),`\n`,_jsxs(_components.p,{children:[`There’s no “link this expense to that invoice” call on the Expenses endpoint. The link is created from the other direction: when you create or edit an invoice and include a line item with an `,_jsx(_components.code,{children:`expense_id`}),`, that’s what sets the expense’s `,_jsx(_components.code,{children:`is_invoiced`}),` and `,_jsx(_components.code,{children:`invoice_id`}),` fields. See `,_jsx(_components.a,{href:`/guides/create-and-send-an-invoice`,children:`Create and send an invoice`}),` for the invoice side of this.`]}),`\n`,_jsxs(_components.p,{children:[`If you edit that invoice later and remove the line referencing the expense (remember, `,_jsx(_components.code,{children:`items`}),` is a full replace on invoice `,_jsx(_components.code,{children:`PUT`}),`), the link is reversed as part of that edit.`]}),`\n`,_jsx(Heading,{level:`2`,id:`list-and-filter-expenses`,children:`List and filter expenses`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://app.billbooks.com/api/public-api/v1/expenses?filter[status]=unbilled\u0026filter[datestart]=2026-08-01\u0026filter[dateend]=2026-08-31\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer bb_live_your_key_here\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Available filters: `,_jsx(_components.code,{children:`vendor`}),`, `,_jsx(_components.code,{children:`category_id`}),`, `,_jsx(_components.code,{children:`client_id`}),`, `,_jsx(_components.code,{children:`project_id`}),`, `,_jsx(_components.code,{children:`datestart`}),`/`,_jsx(_components.code,{children:`dateend`}),` (date range), `,_jsx(_components.code,{children:`currency`}),`, and free-text `,_jsx(_components.code,{children:`q`}),`. `,_jsx(_components.code,{children:`filter[status]`}),` accepts pass-through pseudo-filters like `,_jsx(_components.code,{children:`unbilled`}),`, `,_jsx(_components.code,{children:`invoiced`}),`, `,_jsx(_components.code,{children:`billable`}),`, `,_jsx(_components.code,{children:`non-billable`}),`, `,_jsx(_components.code,{children:`withreceipts`}),`, `,_jsx(_components.code,{children:`withoutreceipts`}),`, and `,_jsx(_components.code,{children:`recurring`}),`, not independently re-validated by this endpoint, they’re whatever the underlying expense model accepts.`]}),`\n`,_jsx(Heading,{level:`2`,id:`deleting-an-expense`,children:`Deleting an expense`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` DELETE`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://app.billbooks.com/api/public-api/v1/expenses?id=203\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer bb_live_your_key_here\"`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`This is a real gap, not a documented design choice: deleting an expense has no guard rail at all, unlike Clients or Items, which block deletion when the record is already in use. An expense that’s already linked to an invoice (`,_jsx(_components.code,{children:`is_invoiced`}),` is true) can be deleted outright through this endpoint. Doing so orphans the invoice line item that references it, the invoice keeps the line, but the expense record behind it is gone.`]})}),`\n`,_jsxs(_components.p,{children:[`If your integration deletes expenses programmatically, check `,_jsx(_components.code,{children:`is_invoiced`}),` yourself first and treat a `,_jsx(_components.code,{children:`true`}),` value as a reason to hold off, the API won’t stop you.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what’s-next`,children:`What’s next`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/guides/create-and-send-an-invoice`,children:`Create and send an invoice`}),` for how `,_jsx(_components.code,{children:`expense_id`}),` on a line item creates the link`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/errors`,children:`Errors`}),` for the full error envelope shape`]}),`\n`]})]})}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":"Log expenses via API","description":"Recording expenses, how invoice-linking works, and a gap you should know about","href":"/guides/log-expenses-via-api"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create an expense","slug":"create-an-expense","depth":2,"children":[]},{"title":"How invoice-linking actually happens","slug":"how-invoice-linking-actually-happens","depth":2,"children":[]},{"title":"List and filter expenses","slug":"list-and-filter-expenses","depth":2,"children":[]},{"title":"Deleting an expense","slug":"deleting-an-expense","depth":2,"children":[]},{"title":"What’s next","slug":"what’s-next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"billbooks","siteName":"Billbooks Developers","title":"Log expenses via API - Billbooks Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-18T03:23:57.920Z","originalFileLocation":"guides/log-expenses-via-api.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=\"Recording expenses, how invoice-linking works, and a gap you should know about\">\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=\"Log expenses via API - Billbooks Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Recording expenses, how invoice-linking works, and a gap you should know about\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Billbooks Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.billbooks.com/guides/log-expenses-via-api\">\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=How-to+guides\u0026amp;title=Log+expenses+via+API\u0026amp;description=Recording+expenses%2C+how+invoice-linking+works%2C+and+a+gap+you+should+know+about\u0026amp;theme=561a283edf63db09ec1b52d8\u0026amp;signature=fe3a712f30ce74e174261c8c10b1b2f6ba6dc7cd365e15fe98f46ff50ed81b90\">\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=\"Log expenses via API - Billbooks Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Recording expenses, how invoice-linking works, and a gap you should know about\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://billbooks.mintlify.site/_mintlify/api/og/v2?division=How-to+guides\u0026amp;title=Log+expenses+via+API\u0026amp;description=Recording+expenses%2C+how+invoice-linking+works%2C+and+a+gap+you+should+know+about\u0026amp;theme=561a283edf63db09ec1b52d8\u0026amp;signature=fe3a712f30ce74e174261c8c10b1b2f6ba6dc7cd365e15fe98f46ff50ed81b90\">\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/guides/log-expenses-via-api\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/log-expenses-via-api.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/guides/log-expenses-via-api#webpage\",\"url\":\"https://docs.billbooks.com/guides/log-expenses-via-api\",\"name\":\"Log expenses via API\",\"description\":\"Recording expenses, how invoice-linking works, and a gap you should know about\",\"dateModified\":\"2026-08-18T03:23:57.920Z\",\"isPartOf\":{\"@id\":\"https://docs.billbooks.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.billbooks.com/guides/log-expenses-via-api#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.billbooks.com/guides/log-expenses-via-api#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"How-to guides\",\"item\":\"https://docs.billbooks.com/guides/create-and-send-an-invoice\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Log expenses via API\",\"item\":\"https://docs.billbooks.com/guides/log-expenses-via-api\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.billbooks.com/guides/log-expenses-via-api#article\",\"headline\":\"Log expenses via API\",\"name\":\"Log expenses via API\",\"description\":\"Recording expenses, how invoice-linking works, and a gap you should know about\",\"url\":\"https://docs.billbooks.com/guides/log-expenses-via-api\",\"mainEntityOfPage\":{\"@id\":\"https://docs.billbooks.com/guides/log-expenses-via-api#webpage\"},\"dateModified\":\"2026-08-18T03:23:57.920Z\",\"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":"/guides/log-expenses-via-api.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","href":"/rate-limits"},{"title":"Errors","href":"/errors"}]},{"group":"How-to guides","pages":[{"title":"Create and send an invoice","href":"/guides/create-and-send-an-invoice"},{"title":"Manage your client list","href":"/guides/manage-your-client-list"},{"title":"Build your item catalog","description":"Creating catalog items, and how stock tracking actually behaves","href":"/guides/build-your-item-catalog"},{"title":"Log expenses via API","href":"/guides/log-expenses-via-api"},{"title":"Create and manage estimates","description":"Estimates are structurally simpler than invoices, and carry no financial side effects","href":"/guides/create-and-manage-estimates"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/overview"}]}]},"basePath":"","title":"Log expenses via API - Billbooks Developers","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}