A Run can have separate usage records for Prompt executions and document processing.
These records may be split further by cost type or credit grant.
A single Run can therefore have several records with the same run_id and type: "agent_run".
The response does not include Prompt IDs, cost types, or credit grants, so records may look alike. Keep each record when calculating usage.
Optionally filter Usage Records created on or after this timestamp (inclusive). Accepts ISO 8601 format (e.g., 2024-01-15T10:30:00Z or 2024-01-15T10:30:00+00:00).
Optionally filter Usage Records created on or before this timestamp (inclusive). Accepts ISO 8601 format (e.g., 2024-01-15T23:59:59Z or 2024-01-15T23:59:59+00:00).
The page size, i.e. number of Usage Records, fetched.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Kolena","colors":{"primary":"#6434c1","light":"#6434c1","dark":"#6434c1"},"logo":{"light":"https://mintcdn.com/kolena/RcQQL0B5MRBeobfg/assets/wordmark.png?fit=max\u0026auto=format\u0026n=RcQQL0B5MRBeobfg\u0026q=85\u0026s=75dc903296dd57fc21c61b4d6aadff38","dark":"https://mintcdn.com/kolena/RcQQL0B5MRBeobfg/assets/wordmark.png?fit=max\u0026auto=format\u0026n=RcQQL0B5MRBeobfg\u0026q=85\u0026s=75dc903296dd57fc21c61b4d6aadff38"},"favicon":"https://mintcdn.com/kolena/RcQQL0B5MRBeobfg/assets/favicon-96x96.webp?fit=max\u0026auto=format\u0026n=RcQQL0B5MRBeobfg\u0026q=85\u0026s=0acb5fa71c8c598c9cedbaafeaef2c0d","api":{"playground":{"display":"none"},"examples":{"defaults":"required"},"mdx":{"server":"https://agents-api.kolena.com"}},"appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"mailto:support@kolena.com","label":"Support"}],"primary":{"type":"button","label":"Kolena","href":"https://agents.kolena.com"}},"footer":{"socials":{"x":"https://x.com/kolenaIO","github":"https://github.com/kolenaIO","linkedin":"https://www.linkedin.com/company/kolena-ai"}},"fonts":{"heading":{"family":"Sora","weight":500},"body":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kolena","hasAudioNarration":false,"actualSubdomain":"kolena","customDomains":["docs.agents.kolena.com"],"gitSource":{"type":"github","owner":"kolenaio","repo":"restructured","deployBranch":"trunk","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae25628830df12299ad8ce0","collectionId":"7d7b1126-27ff-49c4-9d51-fbaa9a746510","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae25628830df12299ad8ce0"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae25628830df12299ad8ce0","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Developers","count":34},{"language":"default","tag":"Users","count":34},{"language":"default","tag":"API Reference","count":30},{"language":"default","tag":"Get Started","count":13},{"language":"default","tag":"Managing Your Organization","count":12},{"language":"default","tag":"Agents","count":11},{"language":"default","tag":"Ground Truths","count":11},{"language":"default","tag":"User Access","count":6},{"language":"default","tag":"FAQ","count":5},{"language":"default","tag":"API Keys","count":4}]},"assistantConfig":{},"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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/list-usage-records","slug":"/api-reference/list-usage-records","pageMetadata":{"title":"List Usage Records","description":"List billed credit usage records for your account, scoped to accessible workspaces","openapi":"openapi.json GET /api/v1/client/usage","href":"/api-reference/list-usage-records"},"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: \"List billed credit usage records for your account, scoped to accessible workspaces\"\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];const limit_0=600;function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Info}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Rate Limit:`}),` This endpoint is limited to `,_jsxs(_components.strong,{children:[limit_0.toLocaleString(),` requests per minute`]}),` per user.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`multiple-usage-records-per-run`,children:`Multiple Usage Records per Run`}),`\n`,_jsxs(_components.p,{children:[`A Run can have separate usage records for Prompt executions and document processing.\nThese records may be split further by cost type or credit grant.\nA single Run can therefore have several records with the same `,_jsx(_components.code,{children:`run_id`}),` and `,_jsx(_components.code,{children:`type: \"agent_run\"`}),`.\nThe response does not include Prompt IDs, cost types, or credit grants, so records may look alike. Keep each record when calculating usage.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{limit_0,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 Records","description":"List billed credit usage records for your account, scoped to accessible workspaces","openapi":"openapi.json GET /api/v1/client/usage","href":"/api-reference/list-usage-records"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[568,656,"(_components.strong,{children:` requests per minute`}),` per"]]},"mdxExtracts":{"tableOfContents":[{"title":"Multiple Usage Records per Run","slug":"multiple-usage-records-per-run","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["client","usage"],"summary":"Client List Usage Records","operationId":"client_list_usage_records_api_v1_client_usage_get","security":["8c372816-3f3a-46df-902f-6abe486e9ebf"],"parameters":["33f52287-2be1-4022-a806-c5e680fc47b6","f32b8aa5-c960-47bb-a6a2-ff43e3adba0c","8039ce77-97f4-4be1-b13b-bd7ce2a13c21","2a3fbdb8-6f28-46b1-935c-86d263cf7ad8","92815f8c-b471-4719-a388-67daeb3843c1","1dd0d67d-eecc-4017-913d-7ff61b6db8aa","8f547c3c-4c1c-4410-9599-ca7dcb72eadf"],"responses":{"200":"67c09ac4-27ef-4a12-990b-8867e2676690","422":"7b56e81f-5e31-4e63-9ea0-dcdf5f27d984"},"method":"get","type":"path","servers":[],"path":"/api/v1/client/usage","baseUrlOptions":["https://agents-api.kolena.com"],"title":"Client List Usage Records","description":"List billed credit usage records for your account, scoped to accessible workspaces","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"33f52287-2be1-4022-a806-c5e680fc47b6":{"name":"page_number","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Optionally specify the index of the Usage Records page to fetch.","default":0,"title":"Page Number","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Optionally specify the index of the Usage Records page to fetch."},"f32b8aa5-c960-47bb-a6a2-ff43e3adba0c":{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":0,"description":"Optionally specify the maximum number of Usage Records to fetch.","default":50,"title":"Page Size","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Optionally specify the maximum number of Usage Records to fetch."},"8039ce77-97f4-4be1-b13b-bd7ce2a13c21":{"name":"created_gte","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Created Gte","description":"Optionally filter Usage Records created on or after this timestamp (inclusive). Accepts ISO 8601 format (e.g., `2024-01-15T10:30:00Z` or `2024-01-15T10:30:00+00:00`).","format":"date-time","uniqueKey":"oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Created Gte","description":"Optionally filter Usage Records created on or after this timestamp (inclusive). Accepts ISO 8601 format (e.g., `2024-01-15T10:30:00Z` or `2024-01-15T10:30:00+00:00`).","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time> | null"},"description":"Optionally filter Usage Records created on or after this timestamp (inclusive). Accepts ISO 8601 format (e.g., `2024-01-15T10:30:00Z` or `2024-01-15T10:30:00+00:00`)."},"2a3fbdb8-6f28-46b1-935c-86d263cf7ad8":{"name":"created_lte","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Created Lte","description":"Optionally filter Usage Records created on or before this timestamp (inclusive). Accepts ISO 8601 format (e.g., `2024-01-15T23:59:59Z` or `2024-01-15T23:59:59+00:00`).","format":"date-time","uniqueKey":"oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Created Lte","description":"Optionally filter Usage Records created on or before this timestamp (inclusive). Accepts ISO 8601 format (e.g., `2024-01-15T23:59:59Z` or `2024-01-15T23:59:59+00:00`).","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time> | null"},"description":"Optionally filter Usage Records created on or before this timestamp (inclusive). Accepts ISO 8601 format (e.g., `2024-01-15T23:59:59Z` or `2024-01-15T23:59:59+00:00`)."},"92815f8c-b471-4719-a388-67daeb3843c1":{"name":"agent_id","in":"query","required":false,"schema":{"oneOf":[{"type":"integer","title":"Agent Id","description":"Optionally filter Usage Records to those associated with this Agent.","uniqueKey":"oneOf.0","typeLabel":"integer"},{"type":"null","title":"Agent Id","description":"Optionally filter Usage Records to those associated with this Agent.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"integer | null"},"description":"Optionally filter Usage Records to those associated with this Agent."},"1dd0d67d-eecc-4017-913d-7ff61b6db8aa":{"name":"workspace_id","in":"query","required":false,"schema":{"oneOf":[{"type":"integer","title":"Workspace Id","description":"Optionally filter Usage Records to those within this Workspace.","uniqueKey":"oneOf.0","typeLabel":"integer"},{"type":"null","title":"Workspace Id","description":"Optionally filter Usage Records to those within this Workspace.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"integer | null"},"description":"Optionally filter Usage Records to those within this Workspace."},"8f547c3c-4c1c-4410-9599-ca7dcb72eadf":{"name":"user","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"User","description":"Optionally filter Usage Records to those attributed to this user.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"User","description":"Optionally filter Usage Records to those attributed to this user.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Optionally filter Usage Records to those attributed to this user."}},"responses":{"67c09ac4-27ef-4a12-990b-8867e2676690":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"records":{"items":{"properties":{"type":{"type":"string","title":"Type","description":"The kind of Usage Record. `agent_run` for Agent Run charges, `validation` for Validation charges. Agent Run charges include Prompt executions and document processing. Records may be split by cost type or credit grant, so multiple `agent_run` records can share a `run_id`. New values may be added in the future.","isRequired":true,"uniqueKey":"records.items.[INDEX].type","typeLabel":"string"},"workspace_id":{"oneOf":[{"type":"integer","title":"Workspace Id","description":"The Workspace associated with this Usage Record, if any.","isRequired":true,"uniqueKey":"records.items.[INDEX].workspace_id.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Workspace Id","description":"The Workspace associated with this Usage Record, if any.","isRequired":true,"uniqueKey":"records.items.[INDEX].workspace_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"records.items.[INDEX].workspace_id","typeLabel":"integer | null"},"agent_id":{"oneOf":[{"type":"integer","title":"Agent Id","description":"The Agent associated with this Usage Record, if any.","isRequired":true,"uniqueKey":"records.items.[INDEX].agent_id.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Agent Id","description":"The Agent associated with this Usage Record, if any.","isRequired":true,"uniqueKey":"records.items.[INDEX].agent_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"records.items.[INDEX].agent_id","typeLabel":"integer | null"},"run_id":{"oneOf":[{"type":"integer","title":"Run Id","description":"The Run associated with this Usage Record, if any. Multiple records can share a `run_id`. Do not use it to remove duplicates.","isRequired":true,"uniqueKey":"records.items.[INDEX].run_id.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Run Id","description":"The Run associated with this Usage Record, if any. Multiple records can share a `run_id`. Do not use it to remove duplicates.","isRequired":true,"uniqueKey":"records.items.[INDEX].run_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"records.items.[INDEX].run_id","typeLabel":"integer | null"},"user":{"type":"string","title":"User","description":"The user whose activity produced this Usage Record.","isRequired":true,"uniqueKey":"records.items.[INDEX].user","typeLabel":"string"},"created":{"type":"string","format":"date-time","title":"Created","description":"ISO 8601 timestamp indicating when this Usage Record was created.","isRequired":true,"uniqueKey":"records.items.[INDEX].created","typeLabel":"string\u003cdate-time>"},"credits_used":{"type":"number","title":"Credits Used","description":"The credits billed for this record. For a Run's billed total, sum `credits_used` across all pages of `agent_run` records with the same `run_id`, including Prompt re-executions. Filters limit which usage is included.","isRequired":true,"uniqueKey":"records.items.[INDEX].credits_used","typeLabel":"number"},"validation_id":{"oneOf":[{"type":"integer","title":"Validation Id","description":"The Validation associated with this Usage Record, if any.","isRequired":true,"uniqueKey":"records.items.[INDEX].validation_id.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Validation Id","description":"The Validation associated with this Usage Record, if any.","isRequired":true,"uniqueKey":"records.items.[INDEX].validation_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"records.items.[INDEX].validation_id","typeLabel":"integer | null"}},"type":"object","required":["type","workspace_id","agent_id","run_id","user","created","credits_used","validation_id"],"title":"ClientUsageRecord","uniqueKey":"records.items.[INDEX]","typeLabel":"ClientUsageRecord · object"},"type":"array","title":"Records","description":"The fetched page of Usage Records. A single Run can have multiple records.","isRequired":true,"uniqueKey":"records","typeLabel":"ClientUsageRecord · object[]"},"total_pages":{"type":"integer","title":"Total Pages","description":"The total number of pages of Usage Records. Use the request arguments `page_number` and `page_size` to control which Usage Records are fetched.","isRequired":true,"uniqueKey":"total_pages","typeLabel":"integer"},"page_number":{"type":"integer","title":"Page Number","description":"The number of the fetched page.","isRequired":true,"uniqueKey":"page_number","typeLabel":"integer"},"page_size":{"type":"integer","title":"Page Size","description":"The page size, i.e. number of Usage Records, fetched.","isRequired":true,"uniqueKey":"page_size","typeLabel":"integer"}},"type":"object","required":["records","total_pages","page_number","page_size"],"title":"ListUsageRecordsResponse","uniqueKey":"","typeLabel":"ListUsageRecordsResponse · object"},"examples":{"Example":{"title":"Example","value":{"records":[{"type":"\u003cstring>","workspace_id":123,"agent_id":123,"run_id":123,"user":"\u003cstring>","created":"2023-11-07T05:31:56Z","credits_used":123,"validation_id":123}],"total_pages":123,"page_number":123,"page_size":123}}},"exampleType":"generated"}},"exampleType":"generated"},"7b56e81f-5e31-4e63-9ea0-dcdf5f27d984":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8c372816-3f3a-46df-902f-6abe486e9ebf":{"HTTPBearer":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`. The `\u003ctoken>` represents your API key, which must be acquired from the Kolena platform.","scopes":[],"schemeName":"HTTPBearer"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`. The `\u003ctoken>` represents your API key, which must be acquired from the Kolena platform.","scopes":[],"schemeName":"HTTPBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`. The `\u003ctoken>` represents your API key, which must be acquired from the Kolena platform.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"kolena","siteName":"Kolena","title":"List Usage Records - Kolena","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-21T22:41:41.551Z","originalFileLocation":"api-reference/list-usage-records.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List billed credit usage records for your account, scoped to accessible workspaces\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kolena\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_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/kolena/3gGeYDhdmk73d0dO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Usage Records - Kolena\">\u003cmeta data-mint-head property=\"og:description\" content=\"List billed credit usage records for your account, scoped to accessible workspaces\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kolena\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agents.kolena.com/api-reference/list-usage-records\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kolena.mintlify.app/_mintlify/api/og/v2?division=Usage\u0026amp;title=List+Usage+Records\u0026amp;description=List+billed+credit+usage+records+for+your+account%2C+scoped+to+accessible+workspaces\u0026amp;theme=bc10cb8463226c42749019bb\u0026amp;signature=f73d5a7b7bc58af6c98487ee6a815390fbd56b67d37e397ec71c292ce2ee1666\">\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 Records - Kolena\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List billed credit usage records for your account, scoped to accessible workspaces\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kolena.mintlify.app/_mintlify/api/og/v2?division=Usage\u0026amp;title=List+Usage+Records\u0026amp;description=List+billed+credit+usage+records+for+your+account%2C+scoped+to+accessible+workspaces\u0026amp;theme=bc10cb8463226c42749019bb\u0026amp;signature=f73d5a7b7bc58af6c98487ee6a815390fbd56b67d37e397ec71c292ce2ee1666\">\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/kolena/3gGeYDhdmk73d0dO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kolena\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6434c1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agents.kolena.com/api-reference/list-usage-records\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/list-usage-records.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agents.kolena.com/#organization\",\"name\":\"Kolena\",\"url\":\"https://docs.agents.kolena.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kolena/RcQQL0B5MRBeobfg/assets/wordmark.png?fit=max\u0026auto=format\u0026n=RcQQL0B5MRBeobfg\u0026q=85\u0026s=75dc903296dd57fc21c61b4d6aadff38\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agents.kolena.com#website\",\"name\":\"Kolena\",\"url\":\"https://docs.agents.kolena.com\",\"publisher\":{\"@id\":\"https://docs.agents.kolena.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agents.kolena.com/api-reference/list-usage-records#webpage\",\"url\":\"https://docs.agents.kolena.com/api-reference/list-usage-records\",\"name\":\"List Usage Records\",\"description\":\"List billed credit usage records for your account, scoped to accessible workspaces\",\"dateModified\":\"2026-09-21T22:41:41.551Z\",\"isPartOf\":{\"@id\":\"https://docs.agents.kolena.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agents.kolena.com/api-reference/list-usage-records#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agents.kolena.com/api-reference/list-usage-records#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.agents.kolena.com/api-reference/quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Usage Records\",\"item\":\"https://docs.agents.kolena.com/api-reference/list-usage-records\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.agents.kolena.com/api-reference/list-usage-records#apireference\",\"headline\":\"List Usage Records\",\"name\":\"List Usage Records\",\"description\":\"List billed credit usage records for your account, scoped to accessible workspaces\",\"url\":\"https://docs.agents.kolena.com/api-reference/list-usage-records\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agents.kolena.com/api-reference/list-usage-records#webpage\"},\"dateModified\":\"2026-09-21T22:41:41.551Z\",\"publisher\":{\"@id\":\"https://docs.agents.kolena.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agents.kolena.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kolena\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Kolena","nav":{"global":null,"tabs":[{"tab":"Users","pages":[{"title":"Users","href":"/introduction"}]},{"tab":"Developers","groups":[{"group":"Connecting to Kolena","pages":[{"title":"Overview","href":"/connecting-to-kolena"},{"title":"Manage API Keys","href":"/api-keys"}]},{"group":"API Reference","pages":[{"title":"Quickstart Guide","href":"/api-reference/quickstart"},{"group":"Agents","pages":[{"title":"List Agents","openapi":"openapi.json GET /api/v1/client/agents","href":"/api-reference/list-agents"},{"title":"Get Agent","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}","href":"/api-reference/get-agent"},{"title":"Copy Agent","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/copy","href":"/api-reference/copy-agent"},{"title":"Update Agent","openapi":"openapi.json PATCH /api/v1/client/agents/{agent_id}","href":"/api-reference/update-agent"},{"title":"Add Agent Run","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/runs","href":"/api-reference/add-agent-run"},{"title":"Add Agent Run (and Wait)","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/runs/wait","href":"/api-reference/add-agent-run-wait"},{"title":"List Agent Runs","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/runs","href":"/api-reference/list-agent-runs"},{"title":"Get Agent Run","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/runs/{run_id}","href":"/api-reference/get-agent-run"},{"title":"Download Agent Run Templated Output","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/runs/{run_id}/templated-output","href":"/api-reference/download-agent-run-templated-output"},{"title":"Download Agent Runs Templated Output","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/runs/templated-output","href":"/api-reference/download-agent-runs-templated-output"},{"title":"Delete Agent Run","openapi":"openapi.json DELETE /api/v1/client/agents/{agent_id}/runs/{run_id}","href":"/api-reference/delete-agent-run"}]},{"group":"Access Logs","pages":[{"title":"Query Access Logs","openapi":"PUT /api/v1/client/access-logs/query","href":"/api-reference/query-access-logs"}]},{"group":"Ground Truths","pages":[{"title":"Create Ground Truth","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/ground_truths","href":"/api-reference/ground-truths/create-ground-truth"},{"title":"List Ground Truths","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths","href":"/api-reference/ground-truths/list-ground-truth"},{"title":"Get Ground Truth","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}","href":"/api-reference/ground-truths/get-ground-truth"},{"title":"Delete Ground Truth","openapi":"openapi.json DELETE /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}","href":"/api-reference/ground-truths/delete-ground-truth"},{"title":"Create Ground Truth Version","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/versions","href":"/api-reference/ground-truths/create-ground-truth-version"},{"title":"List Ground Truth Versions","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/versions","href":"/api-reference/ground-truths/list-ground-truth-versions"},{"title":"Get Ground Truth Version","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/versions/{version}","href":"/api-reference/ground-truths/get-ground-truth-version"},{"title":"Create Validation","openapi":"openapi.json POST /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/validations","href":"/api-reference/ground-truths/create-validation"},{"title":"List Validations","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/validations","href":"/api-reference/ground-truths/list-validations"},{"title":"Get Validation","openapi":"openapi.json GET /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/validations/{validation_id}","href":"/api-reference/ground-truths/get-validation"},{"title":"Delete Validation","description":"Delete a Validation for a Ground Truth","openapi":"openapi.json DELETE /api/v1/client/agents/{agent_id}/ground_truths/{ground_truth_id}/validations/{validation_id}","href":"/api-reference/ground-truths/delete-validation"}]},{"group":"Usage","pages":[{"title":"List Usage Records","openapi":"openapi.json GET /api/v1/client/usage","href":"/api-reference/list-usage-records"}]},{"group":"Workspaces","pages":[{"title":"List Workspaces","description":"Return all Workspaces","openapi":"openapi.json GET /api/v1/client/workspaces","href":"/api-reference/list-workspaces"}]},{"group":"API Keys","pages":[{"title":"Create API Key","openapi":"openapi.json POST /api/v1/client/api-keys","href":"/api-reference/create-api-key"},{"title":"List API Keys","openapi":"openapi.json GET /api/v1/client/api-keys","href":"/api-reference/list-api-keys"},{"title":"Get API Key","openapi":"openapi.json GET /api/v1/client/api-keys/{key_id}","href":"/api-reference/get-api-key"},{"title":"Delete API Key","openapi":"openapi.json DELETE /api/v1/client/api-keys/{key_id}","href":"/api-reference/delete-api-key"}]}]},{"group":"Python Client","pages":[{"title":"Quickstart Guide","href":"/python-client/quickstart"}]},{"group":"Webhook","pages":[{"title":"Webhook Integration","href":"/webhook"}]}]}]},"title":"List Usage Records - Kolena","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}