Get a paginated list of posted usage charges for inference requests. Use this endpoint to answer how much you used at the request level — including model, endpoint, token counts, and credit amounts.Returns newest entries first. Only includes finalized usage charges, not pending holds.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Morpheus Inference API","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/morpheus/B8wp8jG_KM5hucbL/logo/Morpheus-white-bg.png?fit=max\u0026auto=format\u0026n=B8wp8jG_KM5hucbL\u0026q=85\u0026s=31fb71bb6dbaeb1bc8c0b205bff83611","dark":"https://mintcdn.com/morpheus/B8wp8jG_KM5hucbL/logo/Morpheus-black-bg.png?fit=max\u0026auto=format\u0026n=B8wp8jG_KM5hucbL\u0026q=85\u0026s=5dabace81afbd3892078ad8d6a8f78e8"},"favicon":"https://mintcdn.com/morpheus/zkkoHtdILftrA39F/favicon.svg?fit=max\u0026auto=format\u0026n=zkkoHtdILftrA39F\u0026q=85\u0026s=527bbf46dec337b03d1521a2600ac73b","api":{"playground":{"proxy":false},"mdx":{"server":"https://api.mor.org"}},"navbar":{"links":[{"href":"mailto:devs@mor.org","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/morpheusais","github":"https://github.com/morpheusais","linkedin":"https://linkedin.com/company/mintlify","discord":"https://discord.gg/kyVaxTHnvB"}},"integrations":{"ga4":{"measurementId":"G-D0TCTKQ051"}},"contextual":{"options":["copy","view","mcp","cursor","chatgpt","claude","perplexity","vscode"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://mor.org/blog"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/kyVaxTHnvB"},{"anchor":"Announcements","icon":"x","href":"https://x.com/morpheusais"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"morpheus","hasAudioNarration":false,"actualSubdomain":"morpheus","customDomains":["apidocs.mor.org"],"gitSource":{"type":"github","owner":"morpheusais","repo":"api-gateway-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{},"buildId":"6ae93ff280bb0649edf3a3b6:success","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"Documentation","count":19},{"language":"default","tag":"API Reference","count":15},{"language":"default","tag":"Models","count":6},{"language":"default","tag":"Billing","count":5},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Guides","count":4},{"language":"default","tag":"Utility","count":3},{"language":"default","tag":"Chat UIs","count":2},{"language":"default","tag":"AI Coding Tools","count":2},{"language":"default","tag":"Agent Frameworks","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/billing/usage","slug":"/api-reference/billing/usage","pageMetadata":{"title":"List Usage","api":"GET /api/v1/billing/usage","description":"Get detailed per-request usage charges with token and model breakdown","href":"/api-reference/billing/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 detailed per-request usage charges with token and model breakdown\"\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`,strong:`strong`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Get a paginated list of `,_jsx(_components.strong,{children:`posted usage charges`}),` for inference requests. Use this endpoint to answer `,_jsx(_components.strong,{children:`how much you used`}),` at the request level — including model, endpoint, token counts, and credit amounts.`]}),`\n`,_jsx(_components.p,{children:`Returns newest entries first. Only includes finalized usage charges, not pending holds.`}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsxs(_components.p,{children:[`API key or Cognito JWT: `,_jsx(_components.code,{children:`Bearer sk-xxxxxx`})]})}),`\n`,_jsx(Heading,{level:`3`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`50`,id:`param-limit`,children:_jsx(_components.p,{children:`Maximum number of items to return (minimum 1).`})}),`\n`,_jsx(ParamField,{query:`offset`,type:`integer`,default:`0`,id:`param-offset`,children:_jsx(_components.p,{children:`Number of items to skip for pagination.`})}),`\n`,_jsx(ParamField,{query:`from`,type:`string`,id:`param-from`,children:_jsx(_components.p,{children:`Filter entries created after this datetime (ISO 8601).`})}),`\n`,_jsx(ParamField,{query:`to`,type:`string`,id:`param-to`,children:_jsx(_components.p,{children:`Filter entries created before this datetime (ISO 8601).`})}),`\n`,_jsx(ParamField,{query:`model`,type:`string`,id:`param-model`,children:_jsx(_components.p,{children:`Filter by model name.`})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`items`,type:`array`,id:`param-items`,children:[_jsx(_components.p,{children:`List of usage entries.`}),_jsxs(Expandable,{title:`Usage entry fields`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Unique entry ID.`})}),_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`When the usage was recorded (ISO 8601).`})}),_jsx(ResponseField,{name:`model_name`,type:`string | null`,id:`param-model-name`,children:_jsx(_components.p,{children:`Human-readable model name.`})}),_jsx(ResponseField,{name:`model_id`,type:`string | null`,id:`param-model-id`,children:_jsx(_components.p,{children:`Model identifier.`})}),_jsx(ResponseField,{name:`endpoint`,type:`string | null`,id:`param-endpoint`,children:_jsxs(_components.p,{children:[`API endpoint that was called (for example, `,_jsx(_components.code,{children:`/api/v1/chat/completions`}),`).`]})}),_jsx(ResponseField,{name:`tokens_input`,type:`integer | null`,id:`param-tokens-input`,children:_jsx(_components.p,{children:`Input tokens consumed.`})}),_jsx(ResponseField,{name:`tokens_output`,type:`integer | null`,id:`param-tokens-output`,children:_jsx(_components.p,{children:`Output tokens consumed.`})}),_jsx(ResponseField,{name:`tokens_total`,type:`integer | null`,id:`param-tokens-total`,children:_jsx(_components.p,{children:`Total tokens consumed.`})}),_jsx(ResponseField,{name:`amount_paid`,type:`string`,id:`param-amount-paid`,children:_jsx(_components.p,{children:`Credits charged to the paid bucket.`})}),_jsx(ResponseField,{name:`amount_staking`,type:`string`,id:`param-amount-staking`,children:_jsx(_components.p,{children:`Credits charged to the daily staking bucket.`})}),_jsx(ResponseField,{name:`amount_total`,type:`string`,id:`param-amount-total`,children:_jsx(_components.p,{children:`Total credits charged for this request.`})}),_jsx(ResponseField,{name:`request_id`,type:`string | null`,id:`param-request-id`,children:_jsx(_components.p,{children:`Request ID for correlation with API logs.`})}),_jsx(ResponseField,{name:`api_key_id`,type:`integer | null`,id:`param-api-key-id`,children:_jsx(_components.p,{children:`ID of the API key used for the request.`})})]})]}),`\n`,_jsx(ResponseField,{name:`total`,type:`integer`,id:`param-total`,children:_jsx(_components.p,{children:`Total number of matching entries.`})}),`\n`,_jsx(ResponseField,{name:`limit`,type:`integer`,id:`param-limit-1`,children:_jsx(_components.p,{children:`Page size used for this response.`})}),`\n`,_jsx(ResponseField,{name:`offset`,type:`integer`,id:`param-offset-1`,children:_jsx(_components.p,{children:`Offset used for this response.`})}),`\n`,_jsx(ResponseField,{name:`has_more`,type:`boolean`,id:`param-has-more`,children:_jsx(_components.p,{children:`Whether additional pages are available.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List Usage","api":"GET /api/v1/billing/usage","description":"Get detailed per-request usage charges with token and model breakdown","href":"/api-reference/billing/usage"}}},"mdxSourceWithNoJs":{"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`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Get a paginated list of `,_jsx(_components.strong,{children:`posted usage charges`}),` for inference requests. Use this endpoint to answer `,_jsx(_components.strong,{children:`how much you used`}),` at the request level — including model, endpoint, token counts, and credit amounts.`]}),`\n`,_jsx(_components.p,{children:`Returns newest entries first. Only includes finalized usage charges, not pending holds.`}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsxs(_components.p,{children:[`API key or Cognito JWT: `,_jsx(_components.code,{children:`Bearer sk-xxxxxx`})]})}),`\n`,_jsx(Heading,{level:`3`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`50`,id:`param-limit`,children:_jsx(_components.p,{children:`Maximum number of items to return (minimum 1).`})}),`\n`,_jsx(ParamField,{query:`offset`,type:`integer`,default:`0`,id:`param-offset`,children:_jsx(_components.p,{children:`Number of items to skip for pagination.`})}),`\n`,_jsx(ParamField,{query:`from`,type:`string`,id:`param-from`,children:_jsx(_components.p,{children:`Filter entries created after this datetime (ISO 8601).`})}),`\n`,_jsx(ParamField,{query:`to`,type:`string`,id:`param-to`,children:_jsx(_components.p,{children:`Filter entries created before this datetime (ISO 8601).`})}),`\n`,_jsx(ParamField,{query:`model`,type:`string`,id:`param-model`,children:_jsx(_components.p,{children:`Filter by model name.`})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`items`,type:`array`,id:`param-items`,children:[_jsx(_components.p,{children:`List of usage entries.`}),_jsxs(Expandable,{title:`Usage entry fields`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Unique entry ID.`})}),_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`When the usage was recorded (ISO 8601).`})}),_jsx(ResponseField,{name:`model_name`,type:`string | null`,id:`param-model-name`,children:_jsx(_components.p,{children:`Human-readable model name.`})}),_jsx(ResponseField,{name:`model_id`,type:`string | null`,id:`param-model-id`,children:_jsx(_components.p,{children:`Model identifier.`})}),_jsx(ResponseField,{name:`endpoint`,type:`string | null`,id:`param-endpoint`,children:_jsxs(_components.p,{children:[`API endpoint that was called (for example, `,_jsx(_components.code,{children:`/api/v1/chat/completions`}),`).`]})}),_jsx(ResponseField,{name:`tokens_input`,type:`integer | null`,id:`param-tokens-input`,children:_jsx(_components.p,{children:`Input tokens consumed.`})}),_jsx(ResponseField,{name:`tokens_output`,type:`integer | null`,id:`param-tokens-output`,children:_jsx(_components.p,{children:`Output tokens consumed.`})}),_jsx(ResponseField,{name:`tokens_total`,type:`integer | null`,id:`param-tokens-total`,children:_jsx(_components.p,{children:`Total tokens consumed.`})}),_jsx(ResponseField,{name:`amount_paid`,type:`string`,id:`param-amount-paid`,children:_jsx(_components.p,{children:`Credits charged to the paid bucket.`})}),_jsx(ResponseField,{name:`amount_staking`,type:`string`,id:`param-amount-staking`,children:_jsx(_components.p,{children:`Credits charged to the daily staking bucket.`})}),_jsx(ResponseField,{name:`amount_total`,type:`string`,id:`param-amount-total`,children:_jsx(_components.p,{children:`Total credits charged for this request.`})}),_jsx(ResponseField,{name:`request_id`,type:`string | null`,id:`param-request-id`,children:_jsx(_components.p,{children:`Request ID for correlation with API logs.`})}),_jsx(ResponseField,{name:`api_key_id`,type:`integer | null`,id:`param-api-key-id`,children:_jsx(_components.p,{children:`ID of the API key used for the request.`})})]})]}),`\n`,_jsx(ResponseField,{name:`total`,type:`integer`,id:`param-total`,children:_jsx(_components.p,{children:`Total number of matching entries.`})}),`\n`,_jsx(ResponseField,{name:`limit`,type:`integer`,id:`param-limit-1`,children:_jsx(_components.p,{children:`Page size used for this response.`})}),`\n`,_jsx(ResponseField,{name:`offset`,type:`integer`,id:`param-offset-1`,children:_jsx(_components.p,{children:`Offset used for this response.`})}),`\n`,_jsx(ResponseField,{name:`has_more`,type:`boolean`,id:`param-has-more`,children:_jsx(_components.p,{children:`Whether additional pages are available.`})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.mor.org/api/v1/billing/usage?limit=10\u0026model=llama-3.3-70b\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk-your-api-key\"`})]}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Success`,numberOfLines:`23`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`23`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0192a1b2-c3d4-7890-abcd-ef1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-05-22T14:30:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"llama-3.3-70b\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x415471125cc4d03b89818acb8426981fa28a3eee03a9097176297a9a6ae87c8d\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/api/v1/chat/completions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tokens_input\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`128`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tokens_output\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`256`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tokens_total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`384`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount_paid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount_staking\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0.0042\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount_total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0.0042\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_key_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`42`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`156`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"limit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"offset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"has_more\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List Usage","api":"GET /api/v1/billing/usage","description":"Get detailed per-request usage charges with token and model breakdown","href":"/api-reference/billing/usage"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.mor.org/api/v1/billing/usage?limit=10\u0026#x26;model=llama-3.3-70b\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization: Bearer sk-your-api-key\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"Success","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"23\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"items\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0192a1b2-c3d4-7890-abcd-ef1234567890\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"created_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-05-22T14:30:00Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"model_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"llama-3.3-70b\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"model_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0x415471125cc4d03b89818acb8426981fa28a3eee03a9097176297a9a6ae87c8d\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"endpoint\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"/api/v1/chat/completions\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"tokens_input\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">128\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"tokens_output\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">256\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"tokens_total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">384\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount_paid\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0.00\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount_staking\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0.0042\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount_total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0.0042\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_abc123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"api_key_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">42\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">156\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"limit\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">10\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"offset\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"has_more\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"List Usage","path":"/api/v1/billing/usage","servers":[{"url":"https://api.mor.org"}],"method":"get","request":{"security":[],"parameters":{"query":{"limit":{"schema":[{"type":"integer","description":"Maximum number of items to return (minimum 1)."}]},"offset":{"schema":[{"type":"integer","description":"Number of items to skip for pagination."}]},"from":{"schema":[{"type":"string","description":"Filter entries created after this datetime (ISO 8601)."}]},"to":{"schema":[{"type":"string","description":"Filter entries created before this datetime (ISO 8601)."}]},"model":{"schema":[{"type":"string","description":"Filter by model name."}]}},"header":{"Authorization":{"schema":[{"type":"string","description":"API key or Cognito JWT: `Bearer sk-xxxxxx`","required":true}]}},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"items":[{"type":"array","items":[{"type":"object","properties":{"id":[{"type":"string","description":"Unique entry ID."}],"created_at":[{"type":"string","description":"When the usage was recorded (ISO 8601)."}],"model_name":[{"type":"object","properties":{},"description":"Human-readable model name."}],"model_id":[{"type":"object","properties":{},"description":"Model identifier."}],"endpoint":[{"type":"object","properties":{},"description":"API endpoint that was called (for example, `/api/v1/chat/completions` )."}],"tokens_input":[{"type":"object","properties":{},"description":"Input tokens consumed."}],"tokens_output":[{"type":"object","properties":{},"description":"Output tokens consumed."}],"tokens_total":[{"type":"object","properties":{},"description":"Total tokens consumed."}],"amount_paid":[{"type":"string","description":"Credits charged to the paid bucket."}],"amount_staking":[{"type":"string","description":"Credits charged to the daily staking bucket."}],"amount_total":[{"type":"string","description":"Total credits charged for this request."}],"request_id":[{"type":"object","properties":{},"description":"Request ID for correlation with API logs."}],"api_key_id":[{"type":"object","properties":{},"description":"ID of the API key used for the request."}]}}],"description":"List of usage entries."}],"total":[{"type":"integer","description":"Total number of matching entries."}],"limit":[{"type":"integer","description":"Page size used for this response."}],"offset":[{"type":"integer","description":"Offset used for this response."}],"has_more":[{"type":"boolean","description":"Whether additional pages are available."}]}}],"examples":{"example":{"value":{"items":[{"id":"\u003cstring>","created_at":"\u003cstring>","model_name":{},"model_id":{},"endpoint":{},"tokens_input":{},"tokens_output":{},"tokens_total":{},"amount_paid":"\u003cstring>","amount_staking":"\u003cstring>","amount_total":"\u003cstring>","request_id":{},"api_key_id":{}}],"total":123,"limit":123,"offset":123,"has_more":true}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"morpheus","siteName":"Morpheus Inference API","title":"List Usage - Morpheus Inference API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-22T14:14:36.259Z","originalFileLocation":"api-reference/billing/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=\"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=\"Get detailed per-request usage charges with token and model breakdown\">\u003cmeta data-mint-head name=\"application-name\" content=\"Morpheus Inference API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/morpheus/kh1rgJ-Pt9Jw2R06/_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/morpheus/kh1rgJ-Pt9Jw2R06/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/morpheus/kh1rgJ-Pt9Jw2R06/_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/morpheus/kh1rgJ-Pt9Jw2R06/_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/morpheus/kh1rgJ-Pt9Jw2R06/_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/morpheus/kh1rgJ-Pt9Jw2R06/_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/morpheus/kh1rgJ-Pt9Jw2R06/_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/morpheus/kh1rgJ-Pt9Jw2R06/_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/morpheus/kh1rgJ-Pt9Jw2R06/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Usage - Morpheus Inference API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get detailed per-request usage charges with token and model breakdown\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Morpheus Inference API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://apidocs.mor.org/api-reference/billing/usage\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://morpheus.mintlify.site/_mintlify/api/og/v2?division=Billing\u0026amp;title=List+Usage\u0026amp;description=Get+detailed+per-request+usage+charges+with+token+and+model+breakdown\u0026amp;theme=86ed7a09bc1f3cc3ab3407c9\u0026amp;signature=5d7080f746e564a28f15f116e8834a4de52c84c89f54aa5259e1796dac9492a0\">\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=\"List Usage - Morpheus Inference API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get detailed per-request usage charges with token and model breakdown\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://morpheus.mintlify.site/_mintlify/api/og/v2?division=Billing\u0026amp;title=List+Usage\u0026amp;description=Get+detailed+per-request+usage+charges+with+token+and+model+breakdown\u0026amp;theme=86ed7a09bc1f3cc3ab3407c9\u0026amp;signature=5d7080f746e564a28f15f116e8834a4de52c84c89f54aa5259e1796dac9492a0\">\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/morpheus/kh1rgJ-Pt9Jw2R06/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Morpheus Inference API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://apidocs.mor.org/api-reference/billing/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/billing/usage.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://apidocs.mor.org/#organization\",\"name\":\"Morpheus Inference API\",\"url\":\"https://apidocs.mor.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/morpheus/B8wp8jG_KM5hucbL/logo/Morpheus-white-bg.png?fit=max\u0026auto=format\u0026n=B8wp8jG_KM5hucbL\u0026q=85\u0026s=31fb71bb6dbaeb1bc8c0b205bff83611\"}},{\"@type\":\"WebSite\",\"@id\":\"https://apidocs.mor.org#website\",\"name\":\"Morpheus Inference API\",\"url\":\"https://apidocs.mor.org\",\"publisher\":{\"@id\":\"https://apidocs.mor.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://apidocs.mor.org/api-reference/billing/usage#webpage\",\"url\":\"https://apidocs.mor.org/api-reference/billing/usage\",\"name\":\"List Usage\",\"description\":\"Get detailed per-request usage charges with token and model breakdown\",\"dateModified\":\"2026-05-22T14:14:36.259Z\",\"isPartOf\":{\"@id\":\"https://apidocs.mor.org#website\"},\"breadcrumb\":{\"@id\":\"https://apidocs.mor.org/api-reference/billing/usage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://apidocs.mor.org/api-reference/billing/usage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Billing\",\"item\":\"https://apidocs.mor.org/api-reference/billing/balance\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Usage\",\"item\":\"https://apidocs.mor.org/api-reference/billing/usage\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://apidocs.mor.org/api-reference/billing/usage#apireference\",\"headline\":\"List Usage\",\"name\":\"List Usage\",\"description\":\"Get detailed per-request usage charges with token and model breakdown\",\"url\":\"https://apidocs.mor.org/api-reference/billing/usage\",\"mainEntityOfPage\":{\"@id\":\"https://apidocs.mor.org/api-reference/billing/usage#webpage\"},\"dateModified\":\"2026-05-22T14:14:36.259Z\",\"publisher\":{\"@id\":\"https://apidocs.mor.org/#organization\"},\"isPartOf\":{\"@id\":\"https://apidocs.mor.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Morpheus Inference API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Morpheus Inference API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/billing/usage.md","siteName":"Morpheus Inference API","nav":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://mor.org/blog"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/kyVaxTHnvB"},{"anchor":"Announcements","icon":"x","href":"https://x.com/morpheusais"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/getting-started/what-is-api-gateway"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Models","pages":[{"title":"List Models","api":"GET /api/v1/models","href":"/api-reference/models/list"},{"title":"List All Models","api":"GET /api/v1/models/allmodels","href":"/api-reference/models/all-models"},{"title":"Get Rated Bids","api":"GET /api/v1/models/ratedbids","href":"/api-reference/models/rated-bids"}]},{"group":"Chat","pages":[{"title":"Chat Completions","api":"POST /api/v1/chat/completions","href":"/api-reference/chat/completions"}]},{"group":"Embeddings","pages":[{"title":"Create Embeddings","api":"POST /api/v1/embeddings","href":"/api-reference/embeddings/create-embeddings"}]},{"group":"Audio","pages":[{"title":"Create Audio Speech","api":"POST /api/v1/audio/speech","href":"/api-reference/audio/speech"}]},{"group":"Billing","pages":[{"title":"Get Balance","api":"GET /api/v1/billing/balance","description":"Check remaining credits, daily staking allowance, and paid balance","href":"/api-reference/billing/balance"},{"title":"List Usage","api":"GET /api/v1/billing/usage","href":"/api-reference/billing/usage"},{"title":"List Usage for Month","api":"GET /api/v1/billing/usage/month","description":"Get detailed usage charges for a specific calendar month","href":"/api-reference/billing/usage-month"},{"title":"Get Monthly Spending","api":"GET /api/v1/billing/spending","href":"/api-reference/billing/spending"},{"title":"List Transactions","api":"GET /api/v1/billing/transactions","href":"/api-reference/billing/transactions"}]},{"group":"Utility","pages":[{"title":"Root","api":"GET /","href":"/api-reference/utility/root"},{"title":"Health Check","api":"GET /health","href":"/api-reference/utility/health"},{"title":"Model Health Check","api":"GET /health/models","href":"/api-reference/utility/health-models"}]}]}]},"basePath":"","title":"List Usage - Morpheus Inference API","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","Page-1CZdsdAn.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js"]}