Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.
Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, member, API key, model, custom fields, or labels.Supported group_by fields: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, user_agent, api, finish_reason, status_code, extra.<field_name>, api_key_label.<label_key>, and group_label.<label_key>.group_by=api returns one group per request type: chat, embedding, image, speech, transcription, or decision.group_by=finish_reason returns one group per finish reason, such as stop, tool_calls or length. Coding agents send many tool_calls requests and one final stop per user prompt, so group_by=api_key_id&group_by=finish_reason&resolution=day gives prompts per key per day as the stop rows. Failed requests have an empty finish reason.group_by=status_code returns one group per HTTP status code, with 0 for successful requests.
Use api_key_label.<label_key> or group_label.<label_key> to break down spend by the labels you set on API keys or groups — for example group_by=api_key_label.team groups usage by each key’s team label. Rows whose key or group is missing the label are grouped under Unknown.
End date in RFC3339 format (e.g., 2025-01-31T23:59:59Z). Optional. Defaults to 24 hours from start if not specified. Must be after start date. The date range cannot exceed 100 days.
Fields to group by: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, user_agent, api, finish_reason, status_code, extra.<field_name>, api_key_label.<label_key>, or group_label.<label_key>. Rows missing a requested label are grouped under "Unknown". Grouping by api returns one group per request type: chat, embedding, image, speech, transcription, or decision. Grouping by user_agent returns one group per client, taken from the User-Agent header with version numbers and parenthesised comments removed and lowercased (for example claude-cli/2.1.221 (external, cli) becomes claude-cli/). Grouping by finish_reason returns one group per finish reason, for example stop or tool_calls, so a coding agent turn that makes several tool calls and ends with stop can be counted by its stop rows. Grouping by status_code returns one group per HTTP status code, with 0 for successful requests. Grouping by finish_reason returns one group per finish reason, for example stop or tool_calls, so a coding agent turn that makes several tool calls and ends with stop can be counted by its stop rows. Grouping by status_code returns one group per HTTP status code, with 0 for successful requests. Can be specified multiple times.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Requesty Docs","description":"Documentation for Requesty, a unified LLM gateway and OpenAI-compatible API for 600+ AI models.","colors":{"primary":"#C8956A","light":"#D4A574","dark":"#E0B88A"},"logo":{"light":"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/light.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=33d22576c8ec4d1e68f24969181684df","dark":"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/dark.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=c21a835e0692187f8c47df7ab6528af9","href":"https://docs.requesty.ai"},"favicon":"https://mintcdn.com/requesty/MM5cSf0NbVkrpoDF/favicon.svg?fit=max\u0026auto=format\u0026n=MM5cSf0NbVkrpoDF\u0026q=85\u0026s=706185ad27099920b149c4ad2f15a5ca","api":{"openapi":["api-reference/requesty_inference-openapi.json","api-reference/requesty_management-openapi.json"],"playground":{}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://docs.requesty.ai/changelog","label":"Changelog"},{"href":"https://docs.requesty.ai/api-reference/requesty_openapi.json","label":"OpenAPI"},{"href":"https://discord.com/invite/Td3rwAHgt4","label":"Discord"}],"primary":{"type":"button","label":"Get Started","href":"https://app.requesty.ai/sign-up"}},"footer":{"socials":{"x":"https://x.com/requestyAI","linkedin":"https://linkedin.com/company/requesty"}},"search":{"prompt":"Search..."},"seo":{"metatags":{"og:site_name":"Requesty Docs"},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":true},"integrations":{"amplitude":{"apiKey":"ce02ec2dce31d2745bd8a3ffaedd53cc"}},"contextual":{"options":["copy","chatgpt","claude","perplexity"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"requesty","hasAudioNarration":false,"actualSubdomain":"requesty","customDomains":["docs.requesty.ai"],"gitSource":{"type":"github","owner":"requestyai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aea22b93f5028ce95ef7e00","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Gateway","count":58},{"language":"default","tag":"Management API","count":37},{"language":"default","tag":"Integrations","count":27},{"language":"default","tag":"Inference API","count":21},{"language":"default","tag":"Inference APIs","count":21},{"language":"default","tag":"Organization","count":15},{"language":"default","tag":"LLM Gateway","count":14},{"language":"default","tag":"Analytics \u0026 Monitoring","count":12},{"language":"default","tag":"Coding Assistants","count":11},{"language":"default","tag":"API Keys","count":9}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"[email protected]","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":[{"filePath":"styles/custom.css","content":":root{--requesty-gold: #C8956A;--requesty-gold-light: #E0B88A;--requesty-gold-muted: rgba(200, 149, 106, 0.15)}::-webkit-scrollbar{width:5px;height:5px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{background:rgba(128, 128, 128, 0.15);border-radius:3px}::-webkit-scrollbar-thumb:hover{background:rgba(128, 128, 128, 0.3)}#navbar{backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px)}img.nav-logo{height:2.25rem!important;max-width:18rem!important;max-height:2.25rem!important}#sidebar{font-size:13.5px!important}#sidebar-content{padding-top:0.5rem}sidebar-group-header{font-weight:600!important;letter-spacing:0.01em;text-transform:none!important}#content-area{max-width:100%}#page-title{font-size:2rem!important;font-weight:600!important;letter-spacing:-0.025em!important;line-height:1.2!important}mdx-content{font-size:15px!important;line-height:1.65!important}mdx-content h2{font-size:1.35rem!important;font-weight:600!important;letter-spacing:-0.015em!important;margin-top:2rem!important;margin-bottom:0.75rem!important}mdx-content h3{font-size:1.1rem!important;font-weight:600!important;margin-top:1.5rem!important;margin-bottom:0.4rem!important}mdx-content p{margin-top:0.6em!important;margin-bottom:0.6em!important}mdx-content li{margin-top:0.2rem!important;margin-bottom:0.2rem!important}code-block{border-radius:12px!important;overflow:hidden}mdx-content code:not(pre code){border:none!important;border-radius:5px!important;padding:2px 6px!important;font-size:0.9em!important}:root:not(.dark) mdx-content code:not(pre code){background:rgba(0, 0, 0, 0.05)!important}:root.dark mdx-content code:not(pre code){background:rgba(255, 255, 255, 0.08)!important}card{border-radius:12px!important;transition:border-color 0.2s ease, background-color 0.2s ease}:root:not(.dark) card{border:1px solid rgba(0, 0, 0, 0.08)!important}:root:not(.dark) card:hover{border-color:rgba(0, 0, 0, 0.15)!important;background:rgba(0, 0, 0, 0.01)!important}:root.dark card{border:1px solid rgba(255, 255, 255, 0.06)!important}:root.dark card:hover{border-color:rgba(255, 255, 255, 0.12)!important;background:rgba(255, 255, 255, 0.02)!important}callout{border-radius:10px!important;border-left-width:3px!important}mdx-content table{border-radius:10px!important;overflow:hidden}mdx-content table th{font-weight:600!important;font-size:0.85rem!important;letter-spacing:0.02em;text-transform:uppercase}mdx-content img{border-radius:10px!important}#request-example,#response-example{border-radius:12px!important;overflow:hidden}api-section{padding-bottom:2rem}:root:not(.dark) api-section{border-bottom:1px solid rgba(0, 0, 0, 0.06)}:root.dark api-section{border-bottom:1px solid rgba(255, 255, 255, 0.05)}api-section-heading-title{font-size:1.75rem!important;font-weight:600!important;letter-spacing:-0.02em!important}#table-of-contents{font-size:13px!important}toc-item{transition:color 0.15s ease}breadcrumb-list{font-size:13px!important;opacity:0.7}nav-tabs-item{font-weight:500!important;letter-spacing:0.01em}#pagination{margin-top:2rem!important;padding-top:1rem!important}:root:not(.dark) #pagination{border-top:1px solid rgba(0, 0, 0, 0.06)!important}:root.dark #pagination{border-top:1px solid rgba(255, 255, 255, 0.05)!important}accordion{border-radius:10px!important}steps{border-left-color:rgba(200, 149, 106, 0.3)!important}step-content{padding-bottom:0.75rem!important}expandable{border-radius:8px!important}#search-bar-entry{border-radius:8px!important}nav-tag-pill{font-size:11px!important;font-weight:600!important;letter-spacing:0.03em;border-radius:4px!important}[data-component-part=\"update-tag\"]{padding:2px 8px!important;border-radius:6px!important;font-size:12px!important}:root:not(.dark) [data-component-part=\"update-tag\"]{background:rgba(0, 0, 0, 0.06)!important;color:rgb(55, 65, 81)!important}:root.dark [data-component-part=\"update-tag\"]{background:rgba(255, 255, 255, 0.1)!important;color:rgb(209, 213, 219)!important}:root:not(.dark) #footer{border-top:1px solid rgba(0, 0, 0, 0.06)!important}:root.dark #footer{border-top:1px solid rgba(255, 255, 255, 0.05)!important}"}],"page":{"pagePath":"api-reference/endpoint/manage-org-get-usage","slug":"/api-reference/endpoint/manage-org-get-usage","pageMetadata":{"title":"Get Organization Usage","openapi":"GET /v1/manage/org/usage","description":"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.","href":"/api-reference/endpoint/manage-org-get-usage"},"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: \"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.\"\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={code:`code`,p:`p`,..._provideComponents(),...props.components},{Tip}=_components;if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, member, API key, model, custom fields, or labels.`}),`\n`,_jsxs(_components.p,{children:[`Supported `,_jsx(_components.code,{children:`group_by`}),` fields: `,_jsx(_components.code,{children:`group_name`}),`, `,_jsx(_components.code,{children:`group_id`}),`, `,_jsx(_components.code,{children:`member_id`}),`, `,_jsx(_components.code,{children:`member_email`}),`, `,_jsx(_components.code,{children:`user_id`}),`, `,_jsx(_components.code,{children:`api_key_id`}),`, `,_jsx(_components.code,{children:`model_requested`}),`, `,_jsx(_components.code,{children:`model_used`}),`, `,_jsx(_components.code,{children:`provider_used`}),`, `,_jsx(_components.code,{children:`is_byok`}),`, `,_jsx(_components.code,{children:`origin_title`}),`, `,_jsx(_components.code,{children:`user_agent`}),`, `,_jsx(_components.code,{children:`api`}),`, `,_jsx(_components.code,{children:`finish_reason`}),`, `,_jsx(_components.code,{children:`status_code`}),`, `,_jsx(_components.code,{children:`extra.\u003cfield_name>`}),`, `,_jsx(_components.code,{children:`api_key_label.\u003clabel_key>`}),`, and `,_jsx(_components.code,{children:`group_label.\u003clabel_key>`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`group_by=api`}),` returns one group per request type: `,_jsx(_components.code,{children:`chat`}),`, `,_jsx(_components.code,{children:`embedding`}),`, `,_jsx(_components.code,{children:`image`}),`, `,_jsx(_components.code,{children:`speech`}),`, `,_jsx(_components.code,{children:`transcription`}),`, or `,_jsx(_components.code,{children:`decision`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`group_by=finish_reason`}),` returns one group per finish reason, such as `,_jsx(_components.code,{children:`stop`}),`, `,_jsx(_components.code,{children:`tool_calls`}),` or `,_jsx(_components.code,{children:`length`}),`. Coding agents send many `,_jsx(_components.code,{children:`tool_calls`}),` requests and one final `,_jsx(_components.code,{children:`stop`}),` per user prompt, so `,_jsx(_components.code,{children:`group_by=api_key_id\u0026group_by=finish_reason\u0026resolution=day`}),` gives prompts per key per day as the `,_jsx(_components.code,{children:`stop`}),` rows. Failed requests have an empty finish reason.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`group_by=status_code`}),` returns one group per HTTP status code, with `,_jsx(_components.code,{children:`0`}),` for successful requests.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`api_key_label.\u003clabel_key>`}),` or `,_jsx(_components.code,{children:`group_label.\u003clabel_key>`}),` to break down spend by the labels you set on API keys or groups — for example `,_jsx(_components.code,{children:`group_by=api_key_label.team`}),` groups usage by each key’s `,_jsx(_components.code,{children:`team`}),` label. Rows whose key or group is missing the label are grouped under `,_jsx(_components.code,{children:`Unknown`}),`.`]})})]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Get Organization Usage","openapi":"GET /v1/manage/org/usage","description":"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.","href":"/api-reference/endpoint/manage-org-get-usage"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get organization usage","description":"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.","parameters":["c17afd63-ffca-4ed9-b815-7d1c558dc84c","6f0ff3d9-caf3-46cd-a4a9-896edd834956","b50d831c-2ddd-4028-860f-ec0f26527463","54f2c792-d6eb-4c91-bc3e-3286e69ea5f9"],"responses":{"200":"b917d2c8-d1d0-4cb9-addd-6494a9a5f6e4","400":"c5bcc4d2-9efa-46e6-abfe-5a62e94e1577","401":"be3ad48a-ba09-4fe0-a17f-61562c310a94","402":"940b04eb-2b4d-489a-8bd7-2904e79539e1","403":"8795a480-63da-44e5-ae47-6d82656ec281","404":"a1af9cad-f918-4fab-b729-8491339ebeff","429":"5c5c17f3-2ea8-49e1-90ba-0c96cbd02688","500":"779e5d57-738e-4e10-acc8-35eb0391b585","502":"61614596-001c-4178-9c57-f08662bf080a"},"operationId":"getOrgUsage","method":"get","type":"path","servers":["d743d707-fe96-4466-bcb0-2ac7b5668436"],"security":["c9c871f5-b0f3-41a4-9b44-22cd139054b1"],"path":"/v1/manage/org/usage","baseUrlOptions":["https://api-v2.requesty.ai"],"title":"Get organization usage","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c17afd63-ffca-4ed9-b815-7d1c558dc84c":{"name":"start","in":"query","required":true,"schema":{"type":"string","format":"date-time","example":"2025-01-01T00:00:00Z","isRequired":true,"description":"Start date in RFC3339 format (e.g., 2025-01-01T00:00:00Z). Required. The date range cannot exceed 100 days from start to end.","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"description":"Start date in RFC3339 format (e.g., 2025-01-01T00:00:00Z). Required. The date range cannot exceed 100 days from start to end."},"6f0ff3d9-caf3-46cd-a4a9-896edd834956":{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date-time","example":"2025-01-31T23:59:59Z","isRequired":false,"description":"End date in RFC3339 format (e.g., 2025-01-31T23:59:59Z). Optional. Defaults to 24 hours from start if not specified. Must be after start date. The date range cannot exceed 100 days.","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"description":"End date in RFC3339 format (e.g., 2025-01-31T23:59:59Z). Optional. Defaults to 24 hours from start if not specified. Must be after start date. The date range cannot exceed 100 days."},"b50d831c-2ddd-4028-860f-ec0f26527463":{"name":"resolution","in":"query","required":false,"schema":{"type":"string","enum":["hour","day","month"],"default":"day","isRequired":false,"description":"Time resolution for aggregation","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Time resolution for aggregation"},"54f2c792-d6eb-4c91-bc3e-3286e69ea5f9":{"name":"group_by","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"Fields to group by: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, user_agent, api, finish_reason, status_code, extra.\u003cfield_name>, api_key_label.\u003clabel_key>, or group_label.\u003clabel_key>. Rows missing a requested label are grouped under \"Unknown\". Grouping by api returns one group per request type: chat, embedding, image, speech, transcription, or decision. Grouping by user_agent returns one group per client, taken from the User-Agent header with version numbers and parenthesised comments removed and lowercased (for example claude-cli/2.1.221 (external, cli) becomes claude-cli/). Grouping by finish_reason returns one group per finish reason, for example stop or tool_calls, so a coding agent turn that makes several tool calls and ends with stop can be counted by its stop rows. Grouping by status_code returns one group per HTTP status code, with 0 for successful requests. Grouping by finish_reason returns one group per finish reason, for example stop or tool_calls, so a coding agent turn that makes several tool calls and ends with stop can be counted by its stop rows. Grouping by status_code returns one group per HTTP status code, with 0 for successful requests. Can be specified multiple times.","uniqueKey":"","typeLabel":"string[]"},"description":"Fields to group by: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, user_agent, api, finish_reason, status_code, extra.\u003cfield_name>, api_key_label.\u003clabel_key>, or group_label.\u003clabel_key>. Rows missing a requested label are grouped under \"Unknown\". Grouping by api returns one group per request type: chat, embedding, image, speech, transcription, or decision. Grouping by user_agent returns one group per client, taken from the User-Agent header with version numbers and parenthesised comments removed and lowercased (for example claude-cli/2.1.221 (external, cli) becomes claude-cli/). Grouping by finish_reason returns one group per finish reason, for example stop or tool_calls, so a coding agent turn that makes several tool calls and ends with stop can be counted by its stop rows. Grouping by status_code returns one group per HTTP status code, with 0 for successful requests. Grouping by finish_reason returns one group per finish reason, for example stop or tool_calls, so a coding agent turn that makes several tool calls and ends with stop can be counted by its stop rows. Grouping by status_code returns one group per HTTP status code, with 0 for successful requests. Can be specified multiple times."}},"responses":{"b917d2c8-d1d0-4cb9-addd-6494a9a5f6e4":{"description":"Successfully retrieved usage data","content":{"application/json":{"schema":{"type":"object","properties":{"usage":{"type":"object","additionalProperties":{"type":"object","properties":{"completions_requests":{"type":"integer","description":"Number of chat completion requests","uniqueKey":"usage.additionalProperties.completions_requests","typeLabel":"integer"},"decision_requests":{"type":"integer","description":"Number of decision requests","uniqueKey":"usage.additionalProperties.decision_requests","typeLabel":"integer"},"embedding_requests":{"type":"integer","description":"Number of embedding requests","uniqueKey":"usage.additionalProperties.embedding_requests","typeLabel":"integer"},"image_requests":{"type":"integer","description":"Number of image generation requests","uniqueKey":"usage.additionalProperties.image_requests","typeLabel":"integer"},"speech_requests":{"type":"integer","description":"Number of text-to-speech requests","uniqueKey":"usage.additionalProperties.speech_requests","typeLabel":"integer"},"transcription_requests":{"type":"integer","description":"Number of speech-to-text requests","uniqueKey":"usage.additionalProperties.transcription_requests","typeLabel":"integer"},"total_requests":{"type":"integer","description":"Total number of requests across all modalities","uniqueKey":"usage.additionalProperties.total_requests","typeLabel":"integer"},"spend":{"type":"number","format":"decimal","description":"Total spend for the period","uniqueKey":"usage.additionalProperties.spend","typeLabel":"number\u003cdecimal>"},"input_tokens":{"type":"integer","description":"Total input tokens consumed","uniqueKey":"usage.additionalProperties.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Total output tokens generated","uniqueKey":"usage.additionalProperties.output_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","description":"Total tokens (input + output)","uniqueKey":"usage.additionalProperties.total_tokens","typeLabel":"integer"},"grouped_data":{"type":"array","items":{"type":"object","properties":{"group_by_values":{"type":"object","additionalProperties":true,"description":"Map of group_by field names to their values for this group","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].group_by_values","typeLabel":"object"},"completions_requests":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].completions_requests","typeLabel":"integer"},"decision_requests":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].decision_requests","typeLabel":"integer"},"embedding_requests":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].embedding_requests","typeLabel":"integer"},"image_requests":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].image_requests","typeLabel":"integer"},"speech_requests":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].speech_requests","typeLabel":"integer"},"transcription_requests":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].transcription_requests","typeLabel":"integer"},"total_requests":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].total_requests","typeLabel":"integer"},"spend":{"type":"number","format":"decimal","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].spend","typeLabel":"number\u003cdecimal>"},"input_tokens":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].output_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX].total_tokens","typeLabel":"integer"}},"uniqueKey":"usage.additionalProperties.grouped_data.items.[INDEX]","typeLabel":"object"},"description":"Breakdown by the requested group_by fields. Only present when group_by is specified.","uniqueKey":"usage.additionalProperties.grouped_data","typeLabel":"object[]"}},"uniqueKey":"usage.additionalProperties","typeLabel":"object"},"description":"Map of period (string) to usage entry","isRequired":true,"uniqueKey":"usage","typeLabel":"object"}},"required":["usage"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"usage":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"c5bcc4d2-9efa-46e6-abfe-5a62e94e1577":{"description":"Bad request - malformed payload or invalid parameters.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"be3ad48a-ba09-4fe0-a17f-61562c310a94":{"description":"Unauthorized - missing or empty Authorization header.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"940b04eb-2b4d-489a-8bd7-2904e79539e1":{"description":"Payment required - organization balance exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8795a480-63da-44e5-ae47-6d82656ec281":{"description":"Forbidden - invalid token or model not in access list.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a1af9cad-f918-4fab-b729-8491339ebeff":{"description":"Not found - provider/model not supported.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5c5c17f3-2ea8-49e1-90ba-0c96cbd02688":{"description":"Rate limit exceeded. Retry after the Retry-After header value.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"779e5d57-738e-4e10-acc8-35eb0391b585":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"61614596-001c-4178-9c57-f08662bf080a":{"description":"Bad gateway - upstream provider returned an invalid response.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["origin","message"],"properties":{"origin":{"type":"string","enum":["router","provider"],"description":"Whether the error originated from Requesty's router or an upstream provider.","isRequired":true,"uniqueKey":"error.origin","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error description.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"origin":"router","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c9c871f5-b0f3-41a4-9b44-22cd139054b1":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key for authentication","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"d743d707-fe96-4466-bcb0-2ac7b5668436":{"url":"https://api-v2.requesty.ai","description":"Management API endpoint"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key for authentication","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key for authentication","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"requesty","siteName":"Requesty Docs","title":"Get Organization Usage - Requesty Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T14:03:32.291Z","gitLastModified":"2026-10-27T14:03:09.000Z","originalFileLocation":"api-reference/endpoint/manage-org-get-usage.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=\"dark\"}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=\"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Requesty Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Organization Usage - Requesty Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Requesty Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://requesty.mintlify.site/_mintlify/api/og/v2?division=Organization\u0026amp;title=Get+Organization+Usage\u0026amp;description=Get+aggregated+usage+statistics+for+your+entire+organization+within+a+date+range.+Supports+aggregation+by+different+time+periods+and+optional+grouping+by+user%2C+\u0026amp;theme=1b9a5094c3592451956d887a\u0026amp;signature=cf631d95b3f413e976601b1c98970eb0191ca3007a18906db2466f1214965260\">\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 Organization Usage - Requesty Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://requesty.mintlify.site/_mintlify/api/og/v2?division=Organization\u0026amp;title=Get+Organization+Usage\u0026amp;description=Get+aggregated+usage+statistics+for+your+entire+organization+within+a+date+range.+Supports+aggregation+by+different+time+periods+and+optional+grouping+by+user%2C+\u0026amp;theme=1b9a5094c3592451956d887a\u0026amp;signature=cf631d95b3f413e976601b1c98970eb0191ca3007a18906db2466f1214965260\">\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/requesty/bWQG6e3TK2khNMP8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Requesty Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C8956A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/manage-org-get-usage.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.requesty.ai/#organization\",\"name\":\"Requesty Docs\",\"url\":\"https://docs.requesty.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/light.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=33d22576c8ec4d1e68f24969181684df\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.requesty.ai#website\",\"name\":\"Requesty Docs\",\"url\":\"https://docs.requesty.ai\",\"publisher\":{\"@id\":\"https://docs.requesty.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage#webpage\",\"url\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage\",\"name\":\"Get Organization Usage\",\"description\":\"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.\",\"dateModified\":\"2026-10-27T14:03:09.000Z\",\"isPartOf\":{\"@id\":\"https://docs.requesty.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Organization\",\"item\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Organization Usage\",\"item\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage#apireference\",\"headline\":\"Get Organization Usage\",\"name\":\"Get Organization Usage\",\"description\":\"Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.\",\"url\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage\",\"mainEntityOfPage\":{\"@id\":\"https://docs.requesty.ai/api-reference/endpoint/manage-org-get-usage#webpage\"},\"dateModified\":\"2026-10-27T14:03:09.000Z\",\"publisher\":{\"@id\":\"https://docs.requesty.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.requesty.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Requesty Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Requesty Docs","nav":{"global":null,"tabs":[{"tab":"Gateway","pages":[{"title":"Gateway","href":"/quickstart"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/requesty-cli"}]},{"tab":"Inference API","pages":[{"title":"Inference API","href":"/api-reference/inference-apis"}]},{"tab":"Management API","groups":[{"group":"API Keys","pages":[{"title":"Overview","href":"/api-reference/management-apis"},{"title":"List API Keys","openapi":"GET /v1/manage/apikey","href":"/api-reference/endpoint/manage-apikey/manage-api-key-list"},{"title":"Get API Key","openapi":"GET /v1/manage/apikey/{id}","href":"/api-reference/endpoint/manage-apikey/manage-api-key-get"},{"title":"Get API Key Usage","openapi":"GET /v1/manage/apikey/{id}/usage","href":"/api-reference/endpoint/manage-apikey/manage-api-key-get-usage"},{"title":"Create API Key","openapi":"POST /v1/manage/apikey","href":"/api-reference/endpoint/manage-apikey/manage-api-key-create"},{"title":"Update API Key Limit","openapi":"POST /v1/manage/apikey/{id}/limit","href":"/api-reference/endpoint/manage-apikey/manage-api-key-update-limit"},{"title":"Update API Key Labels","openapi":"POST /v1/manage/apikey/{id}/label","href":"/api-reference/endpoint/manage-apikey/manage-api-key-update-label"},{"title":"Update API Key Expiry","openapi":"POST /v1/manage/apikey/{id}/expiry","href":"/api-reference/endpoint/manage-apikey/manage-api-key-update-expiry"},{"title":"Delete API Key","openapi":"DELETE /v1/manage/apikey/{id}","href":"/api-reference/endpoint/manage-apikey/manage-api-key-delete"}]},{"group":"Groups","pages":[{"title":"List Groups","openapi":"GET /v1/manage/group","href":"/api-reference/endpoint/manage-group/manage-group-list"},{"title":"Create Group","openapi":"POST /v1/manage/group","href":"/api-reference/endpoint/manage-group/manage-group-create"},{"title":"Get Group","openapi":"GET /v1/manage/group/{id}","href":"/api-reference/endpoint/manage-group/manage-group-get"},{"title":"Delete Group","openapi":"DELETE /v1/manage/group/{id}","href":"/api-reference/endpoint/manage-group/manage-group-delete"},{"title":"Update Group Budget","openapi":"PATCH /v1/manage/group/{id}/budget","href":"/api-reference/endpoint/manage-group/manage-group-update-budget"},{"title":"Update Group Per-User Budget","openapi":"PATCH /v1/manage/group/{id}/budget-per-user","href":"/api-reference/endpoint/manage-group/manage-group-update-budget-per-user"},{"title":"Update Group Labels","openapi":"PATCH /v1/manage/group/{id}/label","href":"/api-reference/endpoint/manage-group/manage-group-update-labels"}]},{"group":"Group Members","pages":[{"title":"Add Group Member","openapi":"POST /v1/manage/group/{id}/member","href":"/api-reference/endpoint/manage-group-member/manage-group-member-add"},{"title":"Update Group Member Role","openapi":"PUT /v1/manage/group/{group_id}/member/{member_id}/role","href":"/api-reference/endpoint/manage-group-member/manage-group-member-update"},{"title":"Update Group Member Budget Override","openapi":"PUT /v1/manage/group/{group_id}/member/{member_id}/budget-override","href":"/api-reference/endpoint/manage-group-member/manage-group-member-budget-override"},{"title":"Remove Group Member","openapi":"DELETE /v1/manage/group/{id}/member","href":"/api-reference/endpoint/manage-group-member/manage-group-member-remove"}]},{"group":"Approved Models","pages":[{"title":"Get Org Approved Models","openapi":"GET /v1/manage/org/approved-model","href":"/api-reference/endpoint/manage-approved-model/manage-approved-model-get"},{"title":"Set Org Approved Models","openapi":"POST /v1/manage/org/approved-model","href":"/api-reference/endpoint/manage-approved-model/manage-approved-model-set"}]},{"group":"Access Lists","pages":[{"title":"List Access Lists","openapi":"GET /v1/manage/access-list","href":"/api-reference/endpoint/manage-access-list/manage-access-list-list"},{"title":"Create Access List","openapi":"POST /v1/manage/access-list","href":"/api-reference/endpoint/manage-access-list/manage-access-list-create"},{"title":"Get Access List","openapi":"GET /v1/manage/access-list/{access_list_id}","href":"/api-reference/endpoint/manage-access-list/manage-access-list-get"},{"title":"Update Access List","openapi":"PATCH /v1/manage/access-list/{access_list_id}","href":"/api-reference/endpoint/manage-access-list/manage-access-list-update"},{"title":"Delete Access List","openapi":"DELETE /v1/manage/access-list/{access_list_id}","href":"/api-reference/endpoint/manage-access-list/manage-access-list-delete"},{"title":"Set Default Group Access List","openapi":"POST /v1/manage/org/group/access-list","href":"/api-reference/endpoint/manage-access-list/manage-access-list-set-group-default"}]},{"group":"Routing Policies","pages":[{"title":"List Policies","openapi":"GET /v1/manage/policy","href":"/api-reference/endpoint/manage-policy/manage-policy-list"},{"title":"Create Policy","openapi":"POST /v1/manage/policy","href":"/api-reference/endpoint/manage-policy/manage-policy-create"},{"title":"Update Policy","openapi":"PATCH /v1/manage/policy/{policy_id}","href":"/api-reference/endpoint/manage-policy/manage-policy-update"},{"title":"Delete Policy","openapi":"DELETE /v1/manage/policy/{policy_id}","href":"/api-reference/endpoint/manage-policy/manage-policy-delete"}]},{"group":"Organization","pages":[{"title":"Get Organization","openapi":"GET /v1/manage/org","href":"/api-reference/endpoint/manage-org-get"},{"title":"List Organization Members","openapi":"GET /v1/manage/org/member","href":"/api-reference/endpoint/manage-org-member-list"},{"title":"Delete Organization Member","openapi":"DELETE /v1/manage/org/member/{user_id}","description":"Offboard a member from your organization. The member is removed from the organization in the identity provider so they can no longer access it, all API keys they created in the organization are invalidated, and they are removed from all of the organization's groups. The member keeps their account and any other organization memberships; if they sign in with no memberships left, a fresh default organization is created for them. Requires an API key with write manage permissions. The endpoint is idempotent: calling it for a user who is not (or no longer) a member returns 200, so it is safe to retry after a partial failure.","href":"/api-reference/endpoint/manage-org-member-delete"},{"title":"Get Organization Usage","openapi":"GET /v1/manage/org/usage","href":"/api-reference/endpoint/manage-org-get-usage"}]},{"group":"Resources","pages":[{"title":"OpenAPI Spec","description":"Download the Requesty Management API OpenAPI specification","icon":"download","href":"/api-reference/openapi-management-spec"}]}]}]},"basePath":"","title":"Get Organization Usage - Requesty Docs","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}