Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET …/usage’s all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one’s heaviest consumer.
One provider-dependent enrichment that was attempted and did not produce a usable value. Never emitted for a value that is legitimately absent.
Available options:
balance,
prices,
limits,
offers
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bonya","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"navbar":{"links":[{"href":"mailto:support@bonya.ai","label":"Support"}],"primary":{"type":"button","label":"Console","href":"https://console.bonya.ai"}},"footer":{"socials":{"github":"https://github.com/bonyai/bonya-docs"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bonya","hasAudioNarration":false,"actualSubdomain":"bonya","customDomains":["docs.bonya.ai"],"gitSource":{"type":"github","owner":"bonyai","repo":"bonya-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6af24c872ee9aa9e77b571ab"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af24e2fd16a64d64ef02d14","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":85},{"language":"default","tag":"Documentation","count":25},{"language":"default","tag":"CLI Reference","count":12},{"language":"default","tag":"Sandboxes","count":11},{"language":"default","tag":"Core concepts","count":10},{"language":"default","tag":"Organizations","count":10},{"language":"default","tag":"Secrets","count":9},{"language":"default","tag":"Previews","count":8},{"language":"default","tag":"Filesystem","count":7},{"language":"default","tag":"Job Schedules","count":7}]},"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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/organizations/get-a-usage-breakdown","slug":"/api-reference/organizations/get-a-usage-breakdown","pageMetadata":{"title":"Get a usage breakdown","description":"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET .../usage's all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one's heaviest consumer.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations/{organization_id}/usage/breakdown","href":"/api-reference/organizations/get-a-usage-breakdown","autogeneratedByOpenApi":true},"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: \"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET …/usage’s all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one’s heaviest consumer.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a usage breakdown","description":"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET .../usage's all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one's heaviest consumer.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations/{organization_id}/usage/breakdown","href":"/api-reference/organizations/get-a-usage-breakdown","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getOrganizationUsageBreakdown","tags":["Organizations"],"security":["3cf3a070-1d4e-40b5-905a-352d4cea372a"],"summary":"Get a usage breakdown","description":"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET .../usage's all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one's heaviest consumer.","parameters":["438adf74-15db-494b-a990-7ce5cddfad7e","2ca78157-fa15-44be-b243-0972b463ae18","e26ab2a9-ad8a-4cf0-8f45-7cf36fb7b2be"],"responses":{"200":"10b94a49-bcee-4bcd-9040-bb222524c8bf","default":"0e5ecb95-c12c-4dd5-97f6-43b45a4861c9"},"method":"get","type":"path","servers":["35dd5221-cc61-4405-b8ac-a811ab25010b"],"path":"/v1/organizations/{organization_id}/usage/breakdown","baseUrlOptions":["https://api.bonya.ai"],"title":"Get a usage breakdown","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"438adf74-15db-494b-a990-7ce5cddfad7e":{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"2ca78157-fa15-44be-b243-0972b463ae18":{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"e26ab2a9-ad8a-4cf0-8f45-7cf36fb7b2be":{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cdate-time>"}}},"responses":{"10b94a49-bcee-4bcd-9040-bb222524c8bf":{"description":"Usage breakdown","content":{"application/json":{"schema":{"type":"object","required":["currency","period","services","members","degraded"],"properties":{"currency":{"type":"string","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"period":{"type":"object","required":["from","to"],"properties":{"from":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"period.from","typeLabel":"string\u003cdate-time>"},"to":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"period.to","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"period","typeLabel":"object"},"services":{"type":"array","items":{"type":"object","required":["metric_code","unit","units"],"properties":{"metric_code":{"type":"string","enum":["nest_compute_seconds","nest_storage_hours"],"isRequired":true,"uniqueKey":"services.items.[INDEX].metric_code","typeLabel":"enum\u003cstring>"},"unit":{"type":"string","isRequired":true,"uniqueKey":"services.items.[INDEX].unit","typeLabel":"string"},"units":{"type":"number","isRequired":true,"uniqueKey":"services.items.[INDEX].units","typeLabel":"number"},"estimated_cents":{"type":"integer","format":"int64","description":"Present only together with share, when prices were read successfully.","uniqueKey":"services.items.[INDEX].estimated_cents","typeLabel":"integer\u003cint64>"},"share":{"type":"number","description":"Has no meaning without a price: it compares metrics measured in different units, so money is the only common unit and there is no unpriced fallback.","uniqueKey":"services.items.[INDEX].share","typeLabel":"number"},"heaviest":{"type":"object","description":"Absent when the metric has no recorded usage at all.","required":["units"],"properties":{"units":{"type":"number","isRequired":true,"uniqueKey":"services.items.[INDEX].heaviest.units","typeLabel":"number"},"user_id":{"type":"string","uniqueKey":"services.items.[INDEX].heaviest.user_id","typeLabel":"string"},"unattributed":{"type":"boolean","uniqueKey":"services.items.[INDEX].heaviest.unattributed","typeLabel":"boolean"}},"uniqueKey":"services.items.[INDEX].heaviest","typeLabel":"object"}},"uniqueKey":"services.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"services","typeLabel":"object[]"},"members":{"type":"array","items":{"type":"object","description":"One member's share of usage. An empty user id is the unattributed bucket -- usage whose opening actor record was lost -- reported as unattributed: true rather than an empty user_id, so a consumer cannot mistake it for a member whose id failed to render. Exactly one of user_id or unattributed is present.","required":["compute_seconds","storage_hours"],"properties":{"compute_seconds":{"type":"number","isRequired":true,"uniqueKey":"members.items.[INDEX].compute_seconds","typeLabel":"number"},"storage_hours":{"type":"number","isRequired":true,"uniqueKey":"members.items.[INDEX].storage_hours","typeLabel":"number"},"user_id":{"type":"string","uniqueKey":"members.items.[INDEX].user_id","typeLabel":"string"},"unattributed":{"type":"boolean","uniqueKey":"members.items.[INDEX].unattributed","typeLabel":"boolean"}},"uniqueKey":"members.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"members","typeLabel":"object[]"},"degraded":{"type":"array","items":{"type":"string","enum":["balance","prices","limits","offers"],"description":"One provider-dependent enrichment that was attempted and did not produce a usable value. Never emitted for a value that is legitimately absent.","uniqueKey":"degraded.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"degraded","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"currency":"\u003cstring>","period":{"from":"2023-11-07T05:31:56Z","to":"2023-11-07T05:31:56Z"},"services":[{"metric_code":"nest_compute_seconds","unit":"\u003cstring>","units":123,"estimated_cents":123,"share":123,"heaviest":{"units":123,"user_id":"\u003cstring>","unattributed":true}}],"members":[{"compute_seconds":123,"storage_hours":123,"user_id":"\u003cstring>","unattributed":true}],"degraded":["balance"]}}},"exampleType":"generated"}},"exampleType":"generated"},"0e5ecb95-c12c-4dd5-97f6-43b45a4861c9":{"description":"RFC 9457 problem","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"code":"\u003cstring>","detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"3cf3a070-1d4e-40b5-905a-352d4cea372a":{"supabaseJwt":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Supabase-issued session JWT; required for org, invite, and key management.","scopes":[],"schemeName":"supabaseJwt"}}},"servers":{"35dd5221-cc61-4405-b8ac-a811ab25010b":{"url":"https://api.bonya.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Supabase-issued session JWT; required for org, invite, and key management.","scopes":[],"schemeName":"supabaseJwt"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Supabase-issued session JWT; required for org, invite, and key management.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"supabaseJwt","name":"Authorization"}],"title":"supabaseJwt"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"bonya","siteName":"Bonya","title":"Get a usage breakdown - Bonya","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T22:43:24.365Z","originalFileLocation":"api-reference/organizations/get-a-usage-breakdown.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=\"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET .../usage\u0026#x27;s all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one\u0026#x27;s heaviest consumer.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bonya\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/bonya/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/bonya/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/bonya/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/bonya/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a usage breakdown - Bonya\">\u003cmeta data-mint-head property=\"og:description\" content=\"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET .../usage\u0026#x27;s all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one\u0026#x27;s heaviest consumer.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bonya\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bonya.mintlify.site/_mintlify/api/og/v2?division=Organizations\u0026amp;title=Get+a+usage+breakdown\u0026amp;description=Owner+or+billing+role.+from+and+to+are+both+required+RFC+3339+timestamps%2C+unlike+GET+...%2Fusage%27s+all-time+default%3B+from+must+precede+to.+Reports+the+two+support\u0026amp;theme=be394bdd824f66fd2549706a\u0026amp;signature=e90271f6eda30e8ba949394966e6975fc168cf62626324ee933b0650de0cfe90\">\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=\"Get a usage breakdown - Bonya\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET .../usage\u0026#x27;s all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one\u0026#x27;s heaviest consumer.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bonya.mintlify.site/_mintlify/api/og/v2?division=Organizations\u0026amp;title=Get+a+usage+breakdown\u0026amp;description=Owner+or+billing+role.+from+and+to+are+both+required+RFC+3339+timestamps%2C+unlike+GET+...%2Fusage%27s+all-time+default%3B+from+must+precede+to.+Reports+the+two+support\u0026amp;theme=be394bdd824f66fd2549706a\u0026amp;signature=e90271f6eda30e8ba949394966e6975fc168cf62626324ee933b0650de0cfe90\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/bonya/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bonya\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/organizations/get-a-usage-breakdown.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bonya.ai/#organization\",\"name\":\"Bonya\",\"url\":\"https://docs.bonya.ai\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bonya.ai#website\",\"name\":\"Bonya\",\"url\":\"https://docs.bonya.ai\",\"publisher\":{\"@id\":\"https://docs.bonya.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown#webpage\",\"url\":\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown\",\"name\":\"Get a usage breakdown\",\"description\":\"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET .../usage's all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one's heaviest consumer.\",\"dateModified\":\"2026-11-09T22:43:24.365Z\",\"isPartOf\":{\"@id\":\"https://docs.bonya.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Organizations\",\"item\":\"https://docs.bonya.ai/api-reference/organizations/list-organizations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a usage breakdown\",\"item\":\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown#apireference\",\"headline\":\"Get a usage breakdown\",\"name\":\"Get a usage breakdown\",\"description\":\"Owner or billing role. from and to are both required RFC 3339 timestamps, unlike GET .../usage's all-time default; from must precede to. Reports the two supported billable metrics with their share of priced usage and each one's heaviest consumer.\",\"url\":\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bonya.ai/api-reference/organizations/get-a-usage-breakdown#webpage\"},\"dateModified\":\"2026-11-09T22:43:24.365Z\",\"publisher\":{\"@id\":\"https://docs.bonya.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bonya.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bonya\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Bonya","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli-reference/overview"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/typescript/installation"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/mcp/overview"}]},{"tab":"API Reference","groups":[{"group":"Templates","pages":[{"title":"List templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/templates","href":"/api-reference/templates/list-templates"},{"title":"Create a template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/templates","href":"/api-reference/templates/create-a-template"},{"title":"Get a template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/templates/{template_id}","href":"/api-reference/templates/get-a-template"},{"title":"Delete a template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/templates/{template_id}","href":"/api-reference/templates/delete-a-template"},{"title":"Update a template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/templates/{template_id}","href":"/api-reference/templates/update-a-template"}]},{"group":"Registry Connections","pages":[{"title":"List registry connections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/registry-connections","href":"/api-reference/registry-connections/list-registry-connections"},{"title":"Create a registry connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/registry-connections","href":"/api-reference/registry-connections/create-a-registry-connection"},{"title":"Delete a registry connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/registry-connections/{connection_id}","href":"/api-reference/registry-connections/delete-a-registry-connection"},{"title":"Update a registry connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/registry-connections/{connection_id}","href":"/api-reference/registry-connections/update-a-registry-connection"},{"title":"Validate a registry connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/registry-connections/{connection_id}/validate","href":"/api-reference/registry-connections/validate-a-registry-connection"}]},{"group":"Secrets","pages":[{"title":"List secrets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/secrets","href":"/api-reference/secrets/list-secrets"},{"title":"Create a secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/secrets","href":"/api-reference/secrets/create-a-secret"},{"title":"Delete a secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/secrets/{secret_id}","href":"/api-reference/secrets/delete-a-secret"},{"title":"Update a secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/secrets/{secret_id}","href":"/api-reference/secrets/update-a-secret"},{"title":"List secret sets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/secret-sets","href":"/api-reference/secrets/list-secret-sets"},{"title":"Create a secret set","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/secret-sets","href":"/api-reference/secrets/create-a-secret-set"},{"title":"Get a secret set","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/secret-sets/{secret_set_id}","href":"/api-reference/secrets/get-a-secret-set"},{"title":"Delete a secret set","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/secret-sets/{secret_set_id}","href":"/api-reference/secrets/delete-a-secret-set"},{"title":"Update a secret set","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/secret-sets/{secret_set_id}","href":"/api-reference/secrets/update-a-secret-set"}]},{"group":"Sandboxes","pages":[{"title":"List sandboxes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox","href":"/api-reference/sandboxes/list-sandboxes"},{"title":"Create a sandbox","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox","href":"/api-reference/sandboxes/create-a-sandbox"},{"title":"List GPU options","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/gpu-options","href":"/api-reference/sandboxes/list-gpu-options"},{"title":"Get a sandbox","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}","href":"/api-reference/sandboxes/get-a-sandbox"},{"title":"Delete a sandbox","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/sandbox/{sandbox_id}","href":"/api-reference/sandboxes/delete-a-sandbox"},{"title":"Pause a sandbox","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/pause","href":"/api-reference/sandboxes/pause-a-sandbox"},{"title":"Hold a sandbox awake","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/keepalive","href":"/api-reference/sandboxes/hold-a-sandbox-awake"},{"title":"Mint an exec capability","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/capability","href":"/api-reference/sandboxes/mint-an-exec-capability"},{"title":"Replace the network policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/sandbox/{sandbox_id}/network","href":"/api-reference/sandboxes/replace-the-network-policy"},{"title":"Fork a sandbox","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/fork","href":"/api-reference/sandboxes/fork-a-sandbox"}]},{"group":"Snapshots","pages":[{"title":"List a sandbox's snapshots","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/snapshots","href":"/api-reference/snapshots/list-a-sandboxs-snapshots"},{"title":"Create a named snapshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/snapshots","href":"/api-reference/snapshots/create-a-named-snapshot"},{"title":"Get a snapshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/snapshot/{snapshot_id}","href":"/api-reference/snapshots/get-a-snapshot"},{"title":"Delete a snapshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/snapshot/{snapshot_id}","href":"/api-reference/snapshots/delete-a-snapshot"}]},{"group":"Previews","pages":[{"title":"List preview URLs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/previews","href":"/api-reference/previews/list-preview-urls"},{"title":"Create a preview URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/previews","href":"/api-reference/previews/create-a-preview-url"},{"title":"Get a preview URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/previews/{preview_id}","href":"/api-reference/previews/get-a-preview-url"},{"title":"Delete a preview URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/sandbox/{sandbox_id}/previews/{preview_id}","href":"/api-reference/previews/delete-a-preview-url"},{"title":"List access grants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/previews/{preview_id}/grants","href":"/api-reference/previews/list-access-grants"},{"title":"Create an access grant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/previews/{preview_id}/grants","href":"/api-reference/previews/create-an-access-grant"},{"title":"Revoke an access grant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/sandbox/{sandbox_id}/previews/{preview_id}/grants/{grant_id}","href":"/api-reference/previews/revoke-an-access-grant"},{"title":"Renew an access grant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/previews/{preview_id}/grants/{grant_id}/renew","href":"/api-reference/previews/renew-an-access-grant"}]},{"group":"Exec","pages":[{"title":"Run a command (TTY)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/exec","href":"/api-reference/exec/run-a-command-tty"},{"title":"Run a command (buffered)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/exec","href":"/api-reference/exec/run-a-command-buffered"}]},{"group":"Sessions","pages":[{"title":"List sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/sessions","href":"/api-reference/sessions/list-sessions"},{"title":"Create a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/sessions","href":"/api-reference/sessions/create-a-session"},{"title":"Attach to a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/sessions/{session_name}/attach","href":"/api-reference/sessions/attach-to-a-session"},{"title":"Kill a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/sessions/{session_name}/kill","href":"/api-reference/sessions/kill-a-session"}]},{"group":"Filesystem","pages":[{"title":"Read a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/fs/read","href":"/api-reference/filesystem/read-a-file"},{"title":"Write a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /v1/sandbox/{sandbox_id}/fs/write","href":"/api-reference/filesystem/write-a-file"},{"title":"List a directory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/fs/list","href":"/api-reference/filesystem/list-a-directory"},{"title":"Get file metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/sandbox/{sandbox_id}/fs/stat","href":"/api-reference/filesystem/get-file-metadata"},{"title":"Create a directory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/fs/mkdir","href":"/api-reference/filesystem/create-a-directory"},{"title":"Rename or move a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/sandbox/{sandbox_id}/fs/rename","href":"/api-reference/filesystem/rename-or-move-a-file"},{"title":"Delete a file or directory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/sandbox/{sandbox_id}/fs","href":"/api-reference/filesystem/delete-a-file-or-directory"}]},{"group":"Jobs","pages":[{"title":"List job runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/job","href":"/api-reference/jobs/list-job-runs"},{"title":"Create a job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/job","href":"/api-reference/jobs/create-a-job"},{"title":"Get a job run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/job/{run_id}","href":"/api-reference/jobs/get-a-job-run"},{"title":"Cancel a job run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/job/{run_id}/cancel","href":"/api-reference/jobs/cancel-a-job-run"}]},{"group":"Job Schedules","pages":[{"title":"List job schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/job-schedule","href":"/api-reference/job-schedules/list-job-schedules"},{"title":"Create a job schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/job-schedule","href":"/api-reference/job-schedules/create-a-job-schedule"},{"title":"Get a job schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/job-schedule/{schedule_id}","href":"/api-reference/job-schedules/get-a-job-schedule"},{"title":"Delete a job schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/job-schedule/{schedule_id}","href":"/api-reference/job-schedules/delete-a-job-schedule"},{"title":"Update a job schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/job-schedule/{schedule_id}","href":"/api-reference/job-schedules/update-a-job-schedule"},{"title":"Pause or resume a job schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/job-schedule/{schedule_id}/pause","href":"/api-reference/job-schedules/pause-or-resume-a-job-schedule"},{"title":"Trigger a job schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/job-schedule/{schedule_id}/trigger","href":"/api-reference/job-schedules/trigger-a-job-schedule"}]},{"group":"Organizations","pages":[{"title":"List organizations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations","href":"/api-reference/organizations/list-organizations"},{"title":"Create an organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/organizations","href":"/api-reference/organizations/create-an-organization"},{"title":"Get an organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations/{organization_id}","href":"/api-reference/organizations/get-an-organization"},{"title":"Rename an organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/organizations/{organization_id}","href":"/api-reference/organizations/rename-an-organization"},{"title":"List members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations/{organization_id}/members","href":"/api-reference/organizations/list-members"},{"title":"Remove a member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/organizations/{organization_id}/members/{user_id}","href":"/api-reference/organizations/remove-a-member"},{"title":"Update a member's role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/organizations/{organization_id}/members/{user_id}","href":"/api-reference/organizations/update-a-members-role"},{"title":"Get usage and credit balance","description":"Owner or billing role. Reports total recorded usage and its current settled credit balance; both are unbounded (all usage recorded so far), not scoped to a billing period.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations/{organization_id}/usage","href":"/api-reference/organizations/get-usage-and-credit-balance"},{"title":"Get a usage breakdown","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations/{organization_id}/usage/breakdown","href":"/api-reference/organizations/get-a-usage-breakdown"},{"title":"Get a usage time series","description":"Owner or billing role. from and to are both required; bucket is hour or day and defaults to day. Only non-empty buckets are returned. estimated_cents is either present on every point or absent from every point: one price read prices the whole series.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations/{organization_id}/usage/series","href":"/api-reference/organizations/get-a-usage-time-series"}]},{"group":"Invitations","pages":[{"title":"List invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/organizations/{organization_id}/invites","href":"/api-reference/invitations/list-invitations"},{"title":"Create an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/organizations/{organization_id}/invites","href":"/api-reference/invitations/create-an-invitation"},{"title":"Revoke an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/organizations/{organization_id}/invites/{invitation_id}","href":"/api-reference/invitations/revoke-an-invitation"},{"title":"Accept an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/invitations/accept","href":"/api-reference/invitations/accept-an-invitation"}]},{"group":"API Keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/api-keys","href":"/api-reference/api-keys/create-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/api-keys/{key_id}","href":"/api-reference/api-keys/revoke-an-api-key"}]},{"group":"Device Login","pages":[{"title":"Start a device login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/device-login","href":"/api-reference/device-login/start-a-device-login"},{"title":"Approve a device login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/device-login/approve","href":"/api-reference/device-login/approve-a-device-login"},{"title":"Poll a device login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/device-login/poll","href":"/api-reference/device-login/poll-a-device-login"}]}]}]},"basePath":"","title":"Get a usage breakdown - Bonya","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}