filter[status]: passed straight through to Billbooks’ own client model, values like active, inactive, or overdue are accepted, but the API doesn’t independently validate the value against a fixed list.
filter[q]: free-text search across name, city, phone, and country.
Omit id (or pass 0) and you get the paginated list above. Pass a positive id and you get that one client. Ask for a client that belongs to a different organization than your key’s and you get 404, identical to asking for one that doesn’t exist at all, see Errors for why that’s deliberate.
currency and language both default to your organization’s own settings if you leave them out, you only need to set them for a client who bills in something different.
Updates are a genuine partial patch, only the fields you submit get changed. One detail worth knowing: contact_name, contact_email, and contact_phone are treated as a group. If you submit any one of the three, the primary contact record is updated using whatever you sent for those present and the existing values for the ones you left out, it isn’t three independent fields under the hood.status is update-only (there’s no such field on create): truthy marks the client active, falsy marks it inactive.
Deletion is a hard delete, there’s no undo. It’s blocked with 409 Conflict if the client has any recorded invoice or estimate, but if the client has never been billed, this removes them (and their contact rows) permanently.
{"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":"guides/manage-your-client-list","slug":"/guides/manage-your-client-list","pageMetadata":{"title":"Manage your client list","description":"Listing, filtering, creating, updating, and deleting clients","href":"/guides/manage-your-client-list"},"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: \"Listing, filtering, creating, updating, and deleting clients\"\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:`Clients are the scope every invoice and estimate hangs off. This guide covers the four operations you’ll actually use day to day.`}),`\n`,_jsx(Heading,{level:`2`,id:`list-and-filter-clients`,children:`List and filter clients`}),`\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/clients?filter[status]=active\u0026filter[q]=acme\"`}),_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(_components.p,{children:`Two filters are available:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`filter[status]`}),`: passed straight through to Billbooks’ own client model, values like `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`inactive`}),`, or `,_jsx(_components.code,{children:`overdue`}),` are accepted, but the API doesn’t independently validate the value against a fixed list.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`filter[q]`}),`: free-text search across name, city, phone, and country.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`get-a-single-client`,children:`Get a single client`}),`\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/clients?id=4821\"`}),_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:[`Omit `,_jsx(_components.code,{children:`id`}),` (or pass `,_jsx(_components.code,{children:`0`}),`) and you get the paginated list above. Pass a positive `,_jsx(_components.code,{children:`id`}),` and you get that one client. Ask for a client that belongs to a different organization than your key’s and you get `,_jsx(_components.code,{children:`404`}),`, identical to asking for one that doesn’t exist at all, see `,_jsx(_components.a,{href:`/errors`,children:`Errors`}),` for why that’s deliberate.`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-client`,children:`Create a client`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,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:`11`,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/clients`}),_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:` \"name\": \"Acme Design Co.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contact_name\": \"Jordan Lee\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contact_email\": \"[email protected]\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"email\": \"[email protected]\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"city\": \"Austin\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"country_id\": 233`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`currency`}),` and `,_jsx(_components.code,{children:`language`}),` both default to your organization’s own settings if you leave them out, you only need to set them for a client who bills in something different.`]}),`\n`,_jsx(Heading,{level:`2`,id:`update-a-client`,children:`Update a client`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,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:` PUT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://app.billbooks.com/api/public-api/v1/clients`}),_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:` \"id\": 4821,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contact_phone\": \"+1-512-555-0142\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Updates are a genuine partial patch, only the fields you submit get changed. One detail worth knowing: `,_jsx(_components.code,{children:`contact_name`}),`, `,_jsx(_components.code,{children:`contact_email`}),`, and `,_jsx(_components.code,{children:`contact_phone`}),` are treated as a group. If you submit any one of the three, the primary contact record is updated using whatever you sent for those present and the existing values for the ones you left out, it isn’t three independent fields under the hood.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`status`}),` is update-only (there’s no such field on create): truthy marks the client active, falsy marks it inactive.`]}),`\n`,_jsx(Heading,{level:`2`,id:`delete-a-client`,children:`Delete a client`}),`\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/clients?id=4821\"`}),_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:[`Deletion is a hard delete, there’s no undo. It’s blocked with `,_jsx(_components.code,{children:`409 Conflict`}),` if the client has any recorded invoice or estimate, but if the client has never been billed, this removes them (and their contact rows) permanently.`]})}),`\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`}),` once you have a client to bill`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/guides/create-and-manage-estimates`,children:`Create and manage estimates`}),` for pre-invoice quotes`]}),`\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":"Manage your client list","description":"Listing, filtering, creating, updating, and deleting clients","href":"/guides/manage-your-client-list"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"List and filter clients","slug":"list-and-filter-clients","depth":2,"children":[]},{"title":"Get a single client","slug":"get-a-single-client","depth":2,"children":[]},{"title":"Create a client","slug":"create-a-client","depth":2,"children":[]},{"title":"Update a client","slug":"update-a-client","depth":2,"children":[]},{"title":"Delete a client","slug":"delete-a-client","depth":2,"children":[]},{"title":"What’s next","slug":"what’s-next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"billbooks","siteName":"Billbooks Developers","title":"Manage your client list - Billbooks Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-18T03:23:57.922Z","originalFileLocation":"guides/manage-your-client-list.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=\"Listing, filtering, creating, updating, and deleting clients\">\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=\"Manage your client list - Billbooks Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Listing, filtering, creating, updating, and deleting clients\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Billbooks Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.billbooks.com/guides/manage-your-client-list\">\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=Manage+your+client+list\u0026amp;description=Listing%2C+filtering%2C+creating%2C+updating%2C+and+deleting+clients\u0026amp;theme=561a283edf63db09ec1b52d8\u0026amp;signature=3efd60f42272b7d1ce52820918454dafb247eb3bd5d3be0c1b660658373d627f\">\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=\"Manage your client list - Billbooks Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Listing, filtering, creating, updating, and deleting clients\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://billbooks.mintlify.site/_mintlify/api/og/v2?division=How-to+guides\u0026amp;title=Manage+your+client+list\u0026amp;description=Listing%2C+filtering%2C+creating%2C+updating%2C+and+deleting+clients\u0026amp;theme=561a283edf63db09ec1b52d8\u0026amp;signature=3efd60f42272b7d1ce52820918454dafb247eb3bd5d3be0c1b660658373d627f\">\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/manage-your-client-list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/manage-your-client-list.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/manage-your-client-list#webpage\",\"url\":\"https://docs.billbooks.com/guides/manage-your-client-list\",\"name\":\"Manage your client list\",\"description\":\"Listing, filtering, creating, updating, and deleting clients\",\"dateModified\":\"2026-08-18T03:23:57.922Z\",\"isPartOf\":{\"@id\":\"https://docs.billbooks.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.billbooks.com/guides/manage-your-client-list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.billbooks.com/guides/manage-your-client-list#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\":\"Manage your client list\",\"item\":\"https://docs.billbooks.com/guides/manage-your-client-list\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.billbooks.com/guides/manage-your-client-list#article\",\"headline\":\"Manage your client list\",\"name\":\"Manage your client list\",\"description\":\"Listing, filtering, creating, updating, and deleting clients\",\"url\":\"https://docs.billbooks.com/guides/manage-your-client-list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.billbooks.com/guides/manage-your-client-list#webpage\"},\"dateModified\":\"2026-08-18T03:23:57.922Z\",\"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/manage-your-client-list.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","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","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","href":"/guides/create-and-manage-estimates"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/overview"}]}]},"basePath":"","title":"Manage your client list - Billbooks Developers","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}