What bounds your bill today, including the control that does not exist.
There is no dollar limit you can set on this surface today. You cannot set
a limit that suspends a device or refuses the next one.That is worth stating first, because the alternative is a reader who assumes a
cap is there. What follows is what actually bounds your bill. The honest
answer to “how do I avoid a surprise bill” is a handful of existing limits
rather than one switch.
What bounds your bill today
A per minute phone spends only what you paid in
Per minute phones run on a prepaid balance (see
Billing modes). A phone is charged each minute
from that balance, so you cannot spend more than you have added:
When the balance runs out, the phone ends. Nothing is charged to a card
behind your back.
We email you about 10 minutes before the balance would run out, so you can
add funds or return the phone first.
A top-up you open and then leave on the Stripe page closes, and nothing is
charged for it.
Returning a phone stops its charge.
Nothing pauses the charge while a phone is rented to you, whether or not
anything is using it, so return a phone when you are done with it.
Monthly mode removes the variable
A monthly device has no meter, no allowance and no overage: it is billed every
30 days, and running it all the time leaves the invoice the same. If
predictability matters more than the arithmetic, that is the mode that gives it
to you outright. Cancel order on the console’s Billing page stops the next
charge. See Billing modes.
A lease frees a device you forgot
A lease expires on its own after 10 minutes, and it can be renewed, but no
lease may live longer than 60 minutes from when it was acquired. A client
that crashed stops renewing, and the device frees itself within 10 minutes.A lease decides who may act on a device. It is not what you are charged for: a
monthly phone costs the same whether or not it is leased, and a per minute
phone is charged for the minutes it is rented to you. Lease-metered billing is
not sold. See Metering units.
A loop that keeps taking the device never lets it go, so no other
organization can take it. People in your own org can still act on it beside
the loop. If you write a retry that re-acquires on
failure, give it a stopping condition and a ceiling on attempts. The same
goes for a loop that releases the device and then goes on acting on it: a
gesture on a device your organization no longer holds takes it again, and
each new lease starts its own fresh hour.
A run carries its own budget
start_run takes two limits and both of them are real ceilings, not hints:
maxSteps, the number of frames the run may consume. The default is 50 per
run, and your value can only lower it.
deadlineMs, an absolute wall clock deadline, also capped by the deployment
and by your lease’s own expiry, whichever comes first.
A run that reaches either limit is refused its next frame rather than billed
further. See Agent tier.
Reading what you have spent
Two reads, both on the hosted control plane, both needing only devices:read:
GET /v1/usage returns this billing period’s settled usage per device:
measured active time with corrections already applied, how many leases it
came from, and the minutes already reported to billing.
GET /v1/receipts enumerates what your org has actually done, newest first,
with keyset paging.
Use get_receipt when you hold an idempotencyKey and need that one outcome
back. Use GET /v1/receipts when the question is what happened at all.Two things to read carefully before you build a budget alarm on this. Only
settled leases appear in usage, so a lease you are holding right now is not in
those numbers: it is an account of what has finished, not a live meter. And
reportedMinutes is absent until reporting has happened, which is not the
same as zero.The console’s Billing page,
console.phoneuse.com/usage, shows your
usage and your orders.
What is on the way
A dollar limit you set yourself, that suspends a device when it is reached, is
a roadmap item, not a shipped feature. The limits above are the whole of what
bounds your bill today.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PhoneUse","description":"The mobile execution layer for AI agents.","colors":{"primary":"#0c6b4f","light":"#12a06a","dark":"#0a5a43"},"logo":{"light":"https://mintcdn.com/phonebase/asSC9ooLxq3ce7AH/images/logo-light.svg?fit=max\u0026auto=format\u0026n=asSC9ooLxq3ce7AH\u0026q=85\u0026s=797a832db8f0e271d5dbd6beba29a27b","dark":"https://mintcdn.com/phonebase/asSC9ooLxq3ce7AH/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=asSC9ooLxq3ce7AH\u0026q=85\u0026s=82325f8969ce89102cc6e3af558a4436","href":"https://phoneuse.com"},"favicon":"https://mintcdn.com/phonebase/asSC9ooLxq3ce7AH/images/favicon.svg?fit=max\u0026auto=format\u0026n=asSC9ooLxq3ce7AH\u0026q=85\u0026s=5aebe1e05fdad8394b3f4d54e6e75f22","appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"Main site","href":"https://phoneuse.com"}},"footer":{"socials":{"website":"https://phoneuse.com"}},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","mcp"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"phonebase","hasAudioNarration":false,"actualSubdomain":"phonebase","customDomains":["docs.phoneuse.com"],"gitSource":{"type":"github","owner":"phoneuse-official","repo":"phoneuse-api","deployBranch":"docs-release","contentDirectory":"docs/site","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afd0a6c8745fb0d64fce35c","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API","count":158},{"language":"default","tag":"Endpoints","count":155},{"language":"default","tag":"Docs","count":34},{"language":"default","tag":"Managed Proxy","count":22},{"language":"default","tag":"Minute billing","count":22},{"language":"default","tag":"Devices","count":19},{"language":"default","tag":"Apps","count":18},{"language":"default","tag":"Provisioning","count":14},{"language":"default","tag":"API keys","count":12},{"language":"default","tag":"Copilot","count":10}]},"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},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"billing/spending-controls","slug":"/billing/spending-controls","pageMetadata":{"title":"Spending controls","description":"What bounds your bill today, including the control that does not exist.","href":"/billing/spending-controls"},"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: \"What bounds your bill today, including the control that does not exist.\"\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`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`There is `,_jsx(_components.strong,{children:`no dollar limit you can set on this surface today`}),`. You cannot set\na limit that suspends a device or refuses the next one.`]}),`\n`,_jsx(_components.p,{children:`That is worth stating first, because the alternative is a reader who assumes a\ncap is there. What follows is what actually bounds your bill. The honest\nanswer to “how do I avoid a surprise bill” is a handful of existing limits\nrather than one switch.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-bounds-your-bill-today`,children:`What bounds your bill today`}),`\n`,_jsx(Heading,{level:`3`,id:`a-per-minute-phone-spends-only-what-you-paid-in`,children:`A per minute phone spends only what you paid in`}),`\n`,_jsxs(_components.p,{children:[`Per minute phones run on a prepaid balance (see\n`,_jsx(_components.a,{href:`/billing/modes#per-minute`,children:`Billing modes`}),`). A phone is charged each minute\nfrom that balance, so you cannot spend more than you have added:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`When the balance runs out, the phone ends. Nothing is charged to a card\nbehind your back.`}),`\n`,_jsx(_components.li,{children:`We email you about 10 minutes before the balance would run out, so you can\nadd funds or return the phone first.`}),`\n`,_jsx(_components.li,{children:`A top-up you open and then leave on the Stripe page closes, and nothing is\ncharged for it.`}),`\n`,_jsx(_components.li,{children:`Returning a phone stops its charge.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Nothing pauses the charge while a phone is rented to you, whether or not\nanything is using it, so return a phone when you are done with it.`}),`\n`,_jsx(Heading,{level:`3`,id:`monthly-mode-removes-the-variable`,children:`Monthly mode removes the variable`}),`\n`,_jsxs(_components.p,{children:[`A monthly device has no meter, no allowance and no overage: it is billed every\n30 days, and running it all the time leaves the invoice the same. If\npredictability matters more than the arithmetic, that is the mode that gives it\nto you outright. `,_jsx(_components.strong,{children:`Cancel order`}),` on the console’s Billing page stops the next\ncharge. See `,_jsx(_components.a,{href:`/billing/modes#monthly`,children:`Billing modes`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`a-lease-frees-a-device-you-forgot`,children:`A lease frees a device you forgot`}),`\n`,_jsxs(_components.p,{children:[`A lease expires on its own after `,_jsx(_components.strong,{children:`10 minutes`}),`, and it can be renewed, but no\nlease may live longer than `,_jsx(_components.strong,{children:`60 minutes`}),` from when it was acquired. A client\nthat crashed stops renewing, and the device frees itself within 10 minutes.`]}),`\n`,_jsxs(_components.p,{children:[`A lease decides who may act on a device. It is not what you are charged for: a\nmonthly phone costs the same whether or not it is leased, and a per minute\nphone is charged for the minutes it is rented to you. Lease-metered billing is\nnot sold. See `,_jsx(_components.a,{href:`/billing/units#active-time`,children:`Metering units`}),`.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`A loop that keeps taking the device never lets it go, so no other\norganization can take it. People in your own org can still act on it beside\nthe loop. If you write a retry that re-acquires on\nfailure, give it a stopping condition and a ceiling on attempts. The same\ngoes for a loop that releases the device and then goes on acting on it: a\ngesture on a device your organization no longer holds takes it again, and\neach new lease starts its own fresh hour.`})}),`\n`,_jsx(Heading,{level:`3`,id:`a-run-carries-its-own-budget`,children:`A run carries its own budget`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`start_run`}),` takes two limits and both of them are real ceilings, not hints:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`maxSteps`}),`, the number of frames the run may consume. The default is 50 per\nrun, and your value can only lower it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`deadlineMs`}),`, an absolute wall clock deadline, also capped by the deployment\nand by your lease’s own expiry, whichever comes first.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`A run that reaches either limit is refused its next frame rather than billed\nfurther. See `,_jsx(_components.a,{href:`/agent/overview#budgets-live-on-the-control-plane`,children:`Agent tier`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`reading-what-you-have-spent`,children:`Reading what you have spent`}),`\n`,_jsxs(_components.p,{children:[`Two reads, both on the hosted control plane, both needing only `,_jsx(_components.code,{children:`devices:read`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/usage`}),` returns this billing period’s settled usage per device:\nmeasured active time with corrections already applied, how many leases it\ncame from, and the minutes already reported to billing.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/receipts`}),` enumerates what your org has actually done, newest first,\nwith keyset paging.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`get_receipt`}),` when you hold an `,_jsx(_components.code,{children:`idempotencyKey`}),` and need that one outcome\nback. Use `,_jsx(_components.code,{children:`GET /v1/receipts`}),` when the question is what happened at all.`]}),`\n`,_jsxs(_components.p,{children:[`Two things to read carefully before you build a budget alarm on this. Only\nsettled leases appear in usage, so a lease you are holding right now is not in\nthose numbers: it is an account of what has finished, not a live meter. And\n`,_jsx(_components.code,{children:`reportedMinutes`}),` is absent until reporting has happened, which is not the\nsame as zero.`]}),`\n`,_jsxs(_components.p,{children:[`The console’s `,_jsx(_components.strong,{children:`Billing`}),` page,\n`,_jsx(_components.a,{href:`https://console.phoneuse.com/usage`,children:`console.phoneuse.com/usage`}),`, shows your\nusage and your orders.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-is-on-the-way`,children:`What is on the way`}),`\n`,_jsx(_components.p,{children:`A dollar limit you set yourself, that suspends a device when it is reached, is\na roadmap item, not a shipped feature. The limits above are the whole of what\nbounds your bill today.`})]})}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":"Spending controls","description":"What bounds your bill today, including the control that does not exist.","href":"/billing/spending-controls"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What bounds your bill today","slug":"what-bounds-your-bill-today","depth":2,"children":[{"title":"A per minute phone spends only what you paid in","slug":"a-per-minute-phone-spends-only-what-you-paid-in","depth":3,"children":[]},{"title":"Monthly mode removes the variable","slug":"monthly-mode-removes-the-variable","depth":3,"children":[]},{"title":"A lease frees a device you forgot","slug":"a-lease-frees-a-device-you-forgot","depth":3,"children":[]},{"title":"A run carries its own budget","slug":"a-run-carries-its-own-budget","depth":3,"children":[]}]},{"title":"Reading what you have spent","slug":"reading-what-you-have-spent","depth":2,"children":[]},{"title":"What is on the way","slug":"what-is-on-the-way","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"phonebase","siteName":"PhoneUse","title":"Spending controls - PhoneUse","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T20:45:35.293Z","originalFileLocation":"billing/spending-controls.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=\"light\"}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=\"What bounds your bill today, including the control that does not exist.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PhoneUse\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_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/phonebase/kWipq_KjnF--s93A/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_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/phonebase/kWipq_KjnF--s93A/_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/phonebase/kWipq_KjnF--s93A/_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/phonebase/kWipq_KjnF--s93A/_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/phonebase/kWipq_KjnF--s93A/_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/phonebase/kWipq_KjnF--s93A/_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/phonebase/kWipq_KjnF--s93A/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Spending controls - PhoneUse\">\u003cmeta data-mint-head property=\"og:description\" content=\"What bounds your bill today, including the control that does not exist.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PhoneUse\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.phoneuse.com/billing/spending-controls\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://phonebase.mintlify.site/_mintlify/api/og/v2?division=Billing+and+metering\u0026amp;title=Spending+controls\u0026amp;description=What+bounds+your+bill+today%2C+including+the+control+that+does+not+exist.\u0026amp;theme=370fb2999dfbb8f85a217f41\u0026amp;signature=1ce3ed6cc3ab42943ce9d5396590dfa22f259b7c056d6a989d79664bf72a2dfc\">\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=\"Spending controls - PhoneUse\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What bounds your bill today, including the control that does not exist.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://phonebase.mintlify.site/_mintlify/api/og/v2?division=Billing+and+metering\u0026amp;title=Spending+controls\u0026amp;description=What+bounds+your+bill+today%2C+including+the+control+that+does+not+exist.\u0026amp;theme=370fb2999dfbb8f85a217f41\u0026amp;signature=1ce3ed6cc3ab42943ce9d5396590dfa22f259b7c056d6a989d79664bf72a2dfc\">\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/phonebase/kWipq_KjnF--s93A/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PhoneUse\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0c6b4f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.phoneuse.com/billing/spending-controls\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/billing/spending-controls.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.phoneuse.com/#organization\",\"name\":\"PhoneUse\",\"url\":\"https://docs.phoneuse.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/phonebase/asSC9ooLxq3ce7AH/images/logo-light.svg?fit=max\u0026auto=format\u0026n=asSC9ooLxq3ce7AH\u0026q=85\u0026s=797a832db8f0e271d5dbd6beba29a27b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.phoneuse.com#website\",\"name\":\"PhoneUse\",\"url\":\"https://docs.phoneuse.com\",\"publisher\":{\"@id\":\"https://docs.phoneuse.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.phoneuse.com/billing/spending-controls#webpage\",\"url\":\"https://docs.phoneuse.com/billing/spending-controls\",\"name\":\"Spending controls\",\"description\":\"What bounds your bill today, including the control that does not exist.\",\"dateModified\":\"2026-10-21T20:45:35.293Z\",\"isPartOf\":{\"@id\":\"https://docs.phoneuse.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.phoneuse.com/billing/spending-controls#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.phoneuse.com/billing/spending-controls#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Billing and metering\",\"item\":\"https://docs.phoneuse.com/billing/units\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Spending controls\",\"item\":\"https://docs.phoneuse.com/billing/spending-controls\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.phoneuse.com/billing/spending-controls#article\",\"headline\":\"Spending controls\",\"name\":\"Spending controls\",\"description\":\"What bounds your bill today, including the control that does not exist.\",\"url\":\"https://docs.phoneuse.com/billing/spending-controls\",\"mainEntityOfPage\":{\"@id\":\"https://docs.phoneuse.com/billing/spending-controls#webpage\"},\"dateModified\":\"2026-10-21T20:45:35.293Z\",\"publisher\":{\"@id\":\"https://docs.phoneuse.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.phoneuse.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PhoneUse\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"PhoneUse\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/billing/spending-controls.md","siteName":"PhoneUse","nav":{"global":null,"tabs":[{"tab":"Docs","groups":[{"group":"Getting started","pages":[{"title":"PhoneUse docs","href":""},{"title":"Quickstart","href":"/quickstart"},{"title":"The console","href":"/getting-started/console"},{"title":"MCP config","href":"/getting-started/mcp-config"},{"title":"First session","href":"/getting-started/first-session"},{"title":"Reading a trace","href":"/getting-started/trace"},{"title":"For agents","href":"/getting-started/for-agents"}]},{"group":"Guides","pages":[{"title":"Buy and drive a device","href":"/guides/first-device"},{"title":"Webhooks","href":"/guides/webhooks"},{"title":"Install apps from the App Store","href":"/guides/upload-app-package"}]},{"group":"MCP","pages":[{"title":"MCP surface","href":"/mcp/overview"},{"title":"Tool reference","href":"/mcp/reference"},{"title":"Errors","href":"/mcp/errors"},{"title":"Transports","href":"/mcp/transports"},{"title":"Authentication","href":"/mcp/auth"},{"title":"Progress and takeover","href":"/mcp/progress-and-takeover"}]},{"group":"Copilot","pages":[{"title":"Chat with the copilot","href":"/copilot/chat"}]},{"group":"Device capabilities","pages":[{"title":"Device tiers","href":"/devices/tiers"},{"title":"Capabilities","href":"/devices/capabilities"}]},{"group":"Agent tier","pages":[{"title":"Agent tier","href":"/agent/overview"},{"title":"Bring your own worker","href":"/agent/worker"},{"title":"Runs","href":"/agent/runs"}]},{"group":"CLI","pages":[{"title":"CLI","href":"/cli/overview"},{"title":"Installation","href":"/cli/installation"},{"title":"Commands","href":"/cli/commands"},{"title":"CLI in CI","href":"/cli/ci-cd"}]},{"group":"Security and tenancy","pages":[{"title":"Org isolation","href":"/security/org-isolation"},{"title":"Frame retention","href":"/security/frame-retention"},{"title":"A leaked credential","href":"/security/leaked-credentials"},{"title":"Acceptable use","href":"/security/acceptable-use"}]},{"group":"Billing and metering","pages":[{"title":"Metering units","href":"/billing/units"},{"title":"Billing modes","description":"The two ways a device is billed, the current rates, and how to choose between them.","href":"/billing/modes"},{"title":"Spending controls","href":"/billing/spending-controls"}]},{"group":"Changelog","pages":[{"title":"Changelog","description":"What changed on the surfaces you install or call, and how to find out when a shape moves.","href":"/changelog"}]}]},{"tab":"API","pages":[{"title":"API","href":"/api"}]},{"tab":"Help","pages":[{"title":"Help","href":"/help/overview"}]}]},"basePath":"","title":"Spending controls - PhoneUse","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}