Get billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.
Opaque continuation token from a previous response's nextCursor. The cursor carries the filters of the walk it continues, so no filter parameters may be sent alongside it.
Exclusive upper bound on entry timestamps (ISO 8601 UTC, "Z" suffix). Must be later than startTimestamp; consecutive windows sharing a boundary walk the history without gaps or overlaps. Carried forward by the cursor.
{
"error": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}
{
"error": "<string>"
}
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Venice API Docs","colors":{"primary":"#125DA3","light":"#4898E6","dark":"#125DA3"},"logo":{"light":"https://mintcdn.com/veniceai/gFXvp87w4B810n0Y/logo/light.svg?fit=max\u0026auto=format\u0026n=gFXvp87w4B810n0Y\u0026q=85\u0026s=121558c3bff1e4e012fcd34bdc50555c","dark":"https://mintcdn.com/veniceai/0vNwudF9KfvWPUSs/logo/dark.svg?fit=max\u0026auto=format\u0026n=0vNwudF9KfvWPUSs\u0026q=85\u0026s=79383337fb486ba06afb95cb7d0b4bf7","href":"https://venice.ai/?utm_source=venice-api-documentation"},"favicon":"https://mintcdn.com/veniceai/wJjdz14nrhedln0s/favicon.png?fit=max\u0026auto=format\u0026n=wJjdz14nrhedln0s\u0026q=85\u0026s=171a8dd0d43182f3b386c25e13152d92","api":{"openapi":"swagger.yaml","playground":{"proxy":false},"mdx":{"auth":{"method":"bearer"},"server":"https://api.venice.ai/api/v1"}},"appearance":{"default":"dark"},"background":{"color":{"light":"#FFFFFF","dark":"#0E1217"}},"navbar":{"links":[],"primary":{"type":"button","label":"Try Venice","href":"https://venice.ai/chat?utm_source=venice-api-documentation"}},"footer":{"socials":{"x":"https://x.com/AskVenice","discord":"https://discord.gg/askvenice","github":"https://github.com/veniceai","linkedin":"https://www.linkedin.com/company/venice-ai"}},"seo":{"metatags":{"og:site_name":"Venice API Docs","og:locale":"en_US","og:logo":"/logo/light.svg","article:publisher":"Venice AI","twitter:site":"@AskVenice"},"indexing":"navigable"},"icons":{"library":"tabler"},"styling":{"codeblocks":"system","latex":true},"integrations":{"gtm":{"tagId":"GTM-KFP6HX49"},"plausible":{"domain":"docs.venice.ai"}},"navigation":{"languages":[{"language":"en","default":true,"href":"overview/about-venice"},{"language":"pt-BR","href":"pt-BR/overview/about-venice"},{"language":"ar","href":"ar/overview/about-venice"},{"language":"it","href":"it/overview/about-venice"},{"language":"de","href":"de/overview/about-venice"},{"language":"es","href":"es/overview/about-venice"},{"language":"fr","href":"fr/overview/about-venice"},{"language":"zh","href":"zh/overview/about-venice"},{"language":"ko","href":"ko/overview/about-venice"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"veniceai","hasAudioNarration":false,"actualSubdomain":"veniceai","customDomains":["docs.venice.ai"],"gitSource":{"type":"github","owner":"veniceai","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"edits":true,"issues":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aef9f2d20a5c82e8b82d623","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"en","tag":"Models","count":568},{"language":"ar","tag":"النماذج","count":562},{"language":"de","tag":"Modelle","count":562},{"language":"es","tag":"Modelos","count":562},{"language":"fr","tag":"Modèles","count":562},{"language":"it","tag":"Modelli","count":562},{"language":"ko","tag":"모델","count":562},{"language":"pt-BR","tag":"Modelos","count":562},{"language":"zh","tag":"模型","count":562},{"language":"en","tag":"Docs","count":80},{"language":"ar","tag":"التوثيق","count":80},{"language":"de","tag":"Dokumentation","count":80},{"language":"es","tag":"Documentación","count":80},{"language":"fr","tag":"Documentation","count":80},{"language":"it","tag":"Documentazione","count":80},{"language":"ko","tag":"문서","count":80},{"language":"pt-BR","tag":"Documentação","count":80},{"language":"zh","tag":"文档","count":80},{"language":"en","tag":"API Reference","count":58},{"language":"en","tag":"Venice APIs","count":58},{"language":"ar","tag":"مرجع الـ API","count":58},{"language":"ar","tag":"Venice APIs","count":58},{"language":"de","tag":"API-Referenz","count":58},{"language":"de","tag":"Venice APIs","count":58},{"language":"es","tag":"Referencia de la API","count":58},{"language":"es","tag":"Venice APIs","count":58},{"language":"fr","tag":"Référence de l'API","count":58},{"language":"fr","tag":"Venice APIs","count":58},{"language":"it","tag":"Riferimento API","count":58},{"language":"it","tag":"Venice APIs","count":58},{"language":"ko","tag":"API 레퍼런스","count":58},{"language":"ko","tag":"Venice APIs","count":58},{"language":"pt-BR","tag":"Referência da API","count":58},{"language":"pt-BR","tag":"Venice APIs","count":58},{"language":"zh","tag":"API 参考","count":58},{"language":"zh","tag":"Venice APIs","count":58},{"language":"en","tag":"Audio","count":18},{"language":"en","tag":"Learn","count":18},{"language":"ar","tag":"الصوت","count":18},{"language":"ar","tag":"تعلّم","count":18},{"language":"de","tag":"Audio","count":18},{"language":"de","tag":"Lernen","count":18},{"language":"es","tag":"Audio","count":18},{"language":"es","tag":"Aprender","count":18},{"language":"fr","tag":"Audio","count":18},{"language":"fr","tag":"Apprendre","count":18},{"language":"it","tag":"Audio","count":18},{"language":"it","tag":"Impara","count":18},{"language":"ko","tag":"오디오","count":18},{"language":"ko","tag":"학습","count":18},{"language":"pt-BR","tag":"Áudio","count":18},{"language":"pt-BR","tag":"Aprender","count":18},{"language":"zh","tag":"音频","count":18},{"language":"zh","tag":"学习","count":18},{"language":"it","tag":"Immagini","count":12},{"language":"ko","tag":"이미지","count":12},{"language":"zh","tag":"图像","count":12},{"language":"en","tag":"Text \u0026 Chat","count":11},{"language":"ar","tag":"النص والدردشة","count":11},{"language":"de","tag":"Text \u0026 Chat","count":11},{"language":"es","tag":"Texto y chat","count":11},{"language":"fr","tag":"Texte et chat","count":11},{"language":"it","tag":"Testo e chat","count":11},{"language":"ko","tag":"텍스트 및 채팅","count":11},{"language":"pt-BR","tag":"Texto e chat","count":11},{"language":"zh","tag":"文本与聊天","count":11},{"language":"en","tag":"Agents \u0026 Integrations","count":10},{"language":"ar","tag":"الوكلاء والتكاملات","count":10},{"language":"de","tag":"Agenten \u0026 Integrationen","count":10},{"language":"es","tag":"Agentes e integraciones","count":10},{"language":"fr","tag":"Agents et intégrations","count":10},{"language":"it","tag":"Agenti e integrazioni","count":10},{"language":"ko","tag":"에이전트 및 통합","count":10},{"language":"pt-BR","tag":"Agentes e integrações","count":10},{"language":"zh","tag":"智能体与集成","count":10},{"language":"en","tag":"Video","count":9},{"language":"ar","tag":"الفيديو","count":9},{"language":"de","tag":"Video","count":9},{"language":"es","tag":"Vídeo","count":9},{"language":"fr","tag":"Vidéo","count":9},{"language":"it","tag":"Video","count":9},{"language":"ko","tag":"비디오","count":9},{"language":"pt-BR","tag":"Vídeo","count":9},{"language":"zh","tag":"视频","count":9},{"language":"en","tag":"Coding Tools","count":8},{"language":"ar","tag":"أدوات البرمجة","count":8},{"language":"de","tag":"Coding-Tools","count":8},{"language":"es","tag":"Herramientas de código","count":8},{"language":"fr","tag":"Outils de code","count":8},{"language":"pt-BR","tag":"Ferramentas de código","count":8}]},"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":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/veniceai/6040eb1dc6c7d784/style.css"},{"filePath":"model-hub.css","href":"/_mintlify/custom/veniceai/432c8a83b803e62a/model-hub.css"}],"page":{"pagePath":"de/api-reference/endpoint/billing/usage-history","slug":"/de/api-reference/endpoint/billing/usage-history","pageMetadata":{"title":"Abrechnungsnutzungsverlauf","openapi":"GET /billing/usage-history","og:title":"Abrechnungsnutzungsverlauf | Venice API-Dokumentation","og:description":"Durchsuchen Sie Ihre Abrechnungsnutzungseinträge mit stabiler cursorbasierter Paginierung.","description":"Get billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.","href":"/de/api-reference/endpoint/billing/usage-history"},"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 billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Abrechnungsnutzungsverlauf","openapi":"GET /billing/usage-history","og:title":"Abrechnungsnutzungsverlauf | Venice API-Dokumentation","og:description":"Durchsuchen Sie Ihre Abrechnungsnutzungseinträge mit stabiler cursorbasierter Paginierung.","description":"Get billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.","href":"/de/api-reference/endpoint/billing/usage-history"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/veniceai/b6bec6295d99cfeb/model-search.js"],"openApiReferenceData":{"operation":{"description":"Get billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.","operationId":"getBillingUsageHistory","summary":"/api/v1/billing/usage-history","tags":["Billing"],"parameters":["87b2bd0a-b4ab-4c73-82b1-75d4c3df24e9","78e7f227-66ec-475d-969a-74750223a0a1","11be6bd0-8c1d-4569-a11d-9b4b58753658","93f08614-3d6d-4253-8d99-0412fcec9350","d05c18e3-a61a-44a6-a884-be238171471d"],"responses":{"200":"41c8b348-91b7-4705-90bd-ae5bfbb310d5","400":"d04af61c-742f-4329-bd07-f988e7c5b8f0","401":"a907232a-d006-4afb-beea-be453004fa87","403":"cfed3da4-2165-4d49-a975-613f8de94b5c","500":"8a7b81d3-eec7-4e29-816a-057bcadc6e9d"},"method":"get","type":"path","servers":["93ed5cff-98f5-4b43-851e-f27d3e510ac4"],"security":["56fc76a1-b028-42f1-90ef-34bbf6dda2d5"],"path":"/billing/usage-history","baseUrlOptions":["https://api.venice.ai/api/v1"],"title":"/api/v1/billing/usage-history","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"87b2bd0a-b4ab-4c73-82b1-75d4c3df24e9":{"schema":{"type":"string","enum":["USD","DIEM","BUNDLED_CREDITS","EARNED_CREDITS"],"description":"Filter by consumable currency","example":"USD","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"name":"currency","in":"query"},"78e7f227-66ec-475d-969a-74750223a0a1":{"schema":{"type":"string","maxLength":512,"pattern":"^[A-Za-z0-9_-]+$","description":"Opaque continuation token from a previous response's nextCursor. The cursor carries the filters of the walk it continues, so no filter parameters may be sent alongside it.","example":"AZq3fK9tXhIVDm2j4vN8cQwYt1sB6uEoLxRgPzKaJdHfM5nC7yW0K3w","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"name":"cursor","in":"query"},"11be6bd0-8c1d-4569-a11d-9b4b58753658":{"schema":{"type":"string","maxLength":40,"format":"date-time","description":"Exclusive upper bound on entry timestamps (ISO 8601 UTC, \"Z\" suffix). Must be later than startTimestamp; consecutive windows sharing a boundary walk the history without gaps or overlaps. Carried forward by the cursor.","example":"2026-07-01T00:00:00.000Z","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"},"required":false,"name":"endTimestamp","in":"query"},"93f08614-3d6d-4253-8d99-0412fcec9350":{"schema":{"type":"integer","minimum":10,"maximum":1000,"default":1000,"description":"Number of entries per page. Carried forward by the cursor.","example":1000,"isRequired":false,"uniqueKey":"","typeLabel":"integer"},"required":false,"name":"pageSize","in":"query"},"d05c18e3-a61a-44a6-a884-be238171471d":{"schema":{"type":"string","maxLength":40,"format":"date-time","description":"Inclusive lower bound on entry timestamps (ISO 8601 UTC, \"Z\" suffix). First page only: a continuation resumes from the cursor position instead.","example":"2026-06-01T00:00:00.000Z","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"},"required":false,"name":"startTimestamp","in":"query"}},"responses":{"41c8b348-91b7-4705-90bd-ae5bfbb310d5":{"description":"Successful response","headers":{"Content-Disposition":{"schema":{"description":"CSV responses only: attachment whose filename is stamped with the export time (UTC, compact ISO 8601), so each page of a paged walk downloads under a unique name and filenames sort in walk order","example":"attachment; filename=billing-usage-history-20260708T091530123Z.csv","pattern":"^attachment; filename=billing-usage-history-\\d{8}T\\d{9}Z\\.csv$","type":"string"}},"x-next-cursor":{"schema":{"description":"CSV responses only: continuation token for the next page, sent as the cursor query parameter. Absent when this is the last page. JSON responses carry the token in the nextCursor body field instead.","example":"AZq3fK9tXhIVDm2j4vN8cQwYt1sB6uEoLxRgPzKaJdHfM5nC7yW0K3w","maxLength":512,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number","description":"The total amount charged for the billing usage entry","isRequired":true,"uniqueKey":"data.items.[INDEX].amount","typeLabel":"number"},"apiKeyId":{"oneOf":[{"type":"string","format":"uuid","description":"ID of the API key the entry was charged to, matching the id returned by /api_keys. null when the entry was not charged to an API key: usage from the Venice web app, and non-usage entries such as credit purchases, grants and balance transfers.","example":"e28e82dc-9df2-4b47-b726-d0a222ef2ab5","isRequired":true,"uniqueKey":"data.items.[INDEX].apiKeyId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"ID of the API key the entry was charged to, matching the id returned by /api_keys. null when the entry was not charged to an API key: usage from the Venice web app, and non-usage entries such as credit purchases, grants and balance transfers.","example":"e28e82dc-9df2-4b47-b726-d0a222ef2ab5","isRequired":true,"uniqueKey":"data.items.[INDEX].apiKeyId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].apiKeyId","typeLabel":"string\u003cuuid> | null"},"currency":{"type":"string","enum":["USD","DIEM","BUNDLED_CREDITS","EARNED_CREDITS"],"description":"The currency charged for the billing usage entry","example":"USD","isRequired":true,"uniqueKey":"data.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"inferenceDetails":{"oneOf":[{"type":"object","properties":{"completionTokens":{"oneOf":[{"type":"integer","minimum":0,"description":"Number of tokens used in the completion. null for non-LLM usage or when the count was not recorded.","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.completionTokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"description":"Number of tokens used in the completion. null for non-LLM usage or when the count was not recorded.","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.completionTokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.completionTokens","typeLabel":"integer | null"},"inferenceExecutionTime":{"oneOf":[{"type":"integer","minimum":0,"description":"Time taken for inference execution in milliseconds. null when the timing was not recorded.","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.inferenceExecutionTime.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"description":"Time taken for inference execution in milliseconds. null when the timing was not recorded.","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.inferenceExecutionTime.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.inferenceExecutionTime","typeLabel":"integer | null"},"promptTokens":{"oneOf":[{"type":"integer","minimum":0,"description":"Number of tokens requested in the prompt. null for non-LLM usage or when the count was not recorded.","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.promptTokens.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"description":"Number of tokens requested in the prompt. null for non-LLM usage or when the count was not recorded.","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.promptTokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.promptTokens","typeLabel":"integer | null"},"requestId":{"type":"string","description":"Unique identifier for the inference request","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0.requestId","typeLabel":"string"}},"required":["completionTokens","inferenceExecutionTime","promptTokens","requestId"],"additionalProperties":false,"description":"Details about the related inference request, if applicable","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"completionTokens":{"oneOf":[{"type":"integer","minimum":0,"description":"Number of tokens used in the completion. null for non-LLM usage or when the count was not recorded."},{"type":"null","minimum":0,"description":"Number of tokens used in the completion. null for non-LLM usage or when the count was not recorded."}]},"inferenceExecutionTime":{"oneOf":[{"type":"integer","minimum":0,"description":"Time taken for inference execution in milliseconds. null when the timing was not recorded."},{"type":"null","minimum":0,"description":"Time taken for inference execution in milliseconds. null when the timing was not recorded."}]},"promptTokens":{"oneOf":[{"type":"integer","minimum":0,"description":"Number of tokens requested in the prompt. null for non-LLM usage or when the count was not recorded."},{"type":"null","minimum":0,"description":"Number of tokens requested in the prompt. null for non-LLM usage or when the count was not recorded."}]},"requestId":{"type":"string","description":"Unique identifier for the inference request"}},"required":["completionTokens","inferenceExecutionTime","promptTokens","requestId"],"additionalProperties":false,"description":"Details about the related inference request, if applicable","isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].inferenceDetails","typeLabel":"object | null"},"notes":{"type":"string","description":"Notes about the billing usage entry","isRequired":true,"uniqueKey":"data.items.[INDEX].notes","typeLabel":"string"},"pricePerUnitUsd":{"type":"number","description":"The price per unit in USD","isRequired":true,"uniqueKey":"data.items.[INDEX].pricePerUnitUsd","typeLabel":"number"},"sku":{"type":"string","description":"The product associated with the billing usage entry","isRequired":true,"uniqueKey":"data.items.[INDEX].sku","typeLabel":"string"},"timestamp":{"type":"string","maxLength":40,"format":"date-time","description":"The timestamp the billing usage entry was created (ISO 8601)","example":"2026-06-15T19:05:10.504Z","isRequired":true,"uniqueKey":"data.items.[INDEX].timestamp","typeLabel":"string\u003cdate-time>"},"units":{"type":"number","description":"The number of units consumed","isRequired":true,"uniqueKey":"data.items.[INDEX].units","typeLabel":"number"}},"required":["amount","apiKeyId","currency","inferenceDetails","notes","pricePerUnitUsd","sku","timestamp","units"],"additionalProperties":false,"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"maxItems":1000,"description":"Usage entries in ascending timestamp order","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"nextCursor":{"oneOf":[{"type":"string","maxLength":512,"pattern":"^[A-Za-z0-9_-]+$","description":"Continuation token for the next page, to be sent as the cursor query parameter. null means this is the last page.","isRequired":true,"uniqueKey":"nextCursor.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":512,"pattern":"^[A-Za-z0-9_-]+$","description":"Continuation token for the next page, to be sent as the cursor query parameter. null means this is the last page.","isRequired":true,"uniqueKey":"nextCursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nextCursor","typeLabel":"string | null"}},"required":["data","nextCursor"],"additionalProperties":false,"description":"The response schema for the billing usage history endpoint","example":{"data":[{"amount":-0.1,"apiKeyId":"e28e82dc-9df2-4b47-b726-d0a222ef2ab5","currency":"DIEM","inferenceDetails":null,"notes":"API Inference","pricePerUnitUsd":0.1,"sku":"grok-imagine-image-image-unit","timestamp":"2026-06-14T19:52:45.087Z","units":1},{"amount":-0.06356,"apiKeyId":"e28e82dc-9df2-4b47-b726-d0a222ef2ab5","currency":"DIEM","inferenceDetails":{"completionTokens":227,"inferenceExecutionTime":2964,"promptTokens":339,"requestId":"chatcmpl-4007fd29f42b7d3c4107f4345e8d174a"},"notes":"API Inference","pricePerUnitUsd":2.8,"sku":"zai-org-glm-5-1-llm-output-mtoken","timestamp":"2026-06-15T19:05:10.504Z","units":0.000227}],"nextCursor":"AZq3fK9tXhIVDm2j4vN8cQwYt1sB6uEoLxRgPzKaJdHfM5nC7yW0K3w"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"amount":-0.1,"apiKeyId":"e28e82dc-9df2-4b47-b726-d0a222ef2ab5","currency":"DIEM","inferenceDetails":null,"notes":"API Inference","pricePerUnitUsd":0.1,"sku":"grok-imagine-image-image-unit","timestamp":"2026-06-14T19:52:45.087Z","units":1},{"amount":-0.06356,"apiKeyId":"e28e82dc-9df2-4b47-b726-d0a222ef2ab5","currency":"DIEM","inferenceDetails":{"completionTokens":227,"inferenceExecutionTime":2964,"promptTokens":339,"requestId":"chatcmpl-4007fd29f42b7d3c4107f4345e8d174a"},"notes":"API Inference","pricePerUnitUsd":2.8,"sku":"zai-org-glm-5-1-llm-output-mtoken","timestamp":"2026-06-15T19:05:10.504Z","units":0.000227}],"nextCursor":"AZq3fK9tXhIVDm2j4vN8cQwYt1sB6uEoLxRgPzKaJdHfM5nC7yW0K3w"}}},"exampleType":"generated"},"text/csv":{"schema":{"description":"CSV formatted billing usage history data","type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"d04af61c-742f-4329-bd07-f988e7c5b8f0":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","properties":{},"description":"Details about the incorrect input","example":{"_errors":[],"field":{"_errors":["Field is required"]}},"uniqueKey":"details","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":{"_errors":[],"field":{"_errors":["Field is required"]}}}}},"exampleType":"generated"}},"exampleType":"generated"},"a907232a-d006-4afb-beea-be453004fa87":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cfed3da4-2165-4d49-a975-613f8de94b5c":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["This API key is restricted to configured IP addresses, and this request's source IP is not allowed"],"description":"A description of the error","example":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed"}}},"exampleType":"generated"}},"description":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed","exampleType":"generated"},"8a7b81d3-eec7-4e29-816a-057bcadc6e9d":{"description":"An unknown error occurred","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"56fc76a1-b028-42f1-90ef-34bbf6dda2d5":{"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"93ed5cff-98f5-4b43-851e-f27d3e510ac4":{"url":"https://api.venice.ai/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"swagger.yaml"},"subdomain":"veniceai","siteName":"Venice API Docs","title":"Abrechnungsnutzungsverlauf | Venice API-Dokumentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/endpoint/billing/usage-history","matchLevel":1},"pt-BR":{"href":"/pt-BR/api-reference/endpoint/billing/usage-history","matchLevel":1},"ar":{"href":"/ar/api-reference/endpoint/billing/usage-history","matchLevel":1},"it":{"href":"/it/api-reference/endpoint/billing/usage-history","matchLevel":1},"de":{"href":"/de/api-reference/endpoint/billing/usage-history","matchLevel":0},"es":{"href":"/es/api-reference/endpoint/billing/usage-history","matchLevel":1},"fr":{"href":"/fr/api-reference/endpoint/billing/usage-history","matchLevel":1},"zh":{"href":"/zh/api-reference/endpoint/billing/usage-history","matchLevel":1},"ko":{"href":"/ko/api-reference/endpoint/billing/usage-history","matchLevel":1}}},"lastModified":"2026-07-28T18:41:08.744Z","originalFileLocation":"de/api-reference/endpoint/billing/usage-history.mdx","locale":"de"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Venice API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_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/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_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/veniceai/bx2bxRtmLEf0wvnq/_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/veniceai/bx2bxRtmLEf0wvnq/_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/veniceai/bx2bxRtmLEf0wvnq/_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/veniceai/bx2bxRtmLEf0wvnq/_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/veniceai/bx2bxRtmLEf0wvnq/_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/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Abrechnungsnutzungsverlauf | Venice API-Dokumentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Durchsuchen Sie Ihre Abrechnungsnutzungseinträge mit stabiler cursorbasierter Paginierung.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Venice API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://veniceai.mintlify.site/_mintlify/api/og/v2?division=Abrechnung\u0026amp;title=Abrechnungsnutzungsverlauf\u0026amp;description=Get+billing+usage+data+for+the+authenticated+user+as+a+cursor-paginated+walk+in+ascending+timestamp+order.+The+first+request+takes+filter+parameters%3B+while+more\u0026amp;theme=c703b2b369bc0a924505c3f9\u0026amp;signature=4e05228db5e5a8d015c3dfd52935d492f554503ee9b40571eb0ee9307bc4cde2\">\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=\"Abrechnungsnutzungsverlauf | Venice API-Dokumentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Durchsuchen Sie Ihre Abrechnungsnutzungseinträge mit stabiler cursorbasierter Paginierung.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.site/_mintlify/api/og/v2?division=Abrechnung\u0026amp;title=Abrechnungsnutzungsverlauf\u0026amp;description=Get+billing+usage+data+for+the+authenticated+user+as+a+cursor-paginated+walk+in+ascending+timestamp+order.+The+first+request+takes+filter+parameters%3B+while+more\u0026amp;theme=c703b2b369bc0a924505c3f9\u0026amp;signature=4e05228db5e5a8d015c3dfd52935d492f554503ee9b40571eb0ee9307bc4cde2\">\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/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Venice API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#125DA3\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:logo\" content=\"/logo/light.svg\">\u003cmeta data-mint-head name=\"article:publisher\" content=\"Venice AI\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/de/api-reference/endpoint/billing/usage-history.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.venice.ai/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.venice.ai/it/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.venice.ai/es/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.venice.ai/fr/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.venice.ai/zh/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.venice.ai/ko/api-reference/endpoint/billing/usage-history\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.venice.ai/api-reference/endpoint/billing/usage-history\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.venice.ai/#organization\",\"name\":\"Venice API Docs\",\"url\":\"https://docs.venice.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/veniceai/gFXvp87w4B810n0Y/logo/light.svg?fit=max\u0026auto=format\u0026n=gFXvp87w4B810n0Y\u0026q=85\u0026s=121558c3bff1e4e012fcd34bdc50555c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.venice.ai#website\",\"name\":\"Venice API Docs\",\"url\":\"https://docs.venice.ai\",\"publisher\":{\"@id\":\"https://docs.venice.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history#webpage\",\"url\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history\",\"name\":\"Abrechnungsnutzungsverlauf\",\"description\":\"Get billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.\",\"dateModified\":\"2026-07-28T18:41:08.744Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/de/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Abrechnung\",\"item\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/balance\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Abrechnungsnutzungsverlauf\",\"item\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history#apireference\",\"headline\":\"Abrechnungsnutzungsverlauf\",\"name\":\"Abrechnungsnutzungsverlauf\",\"description\":\"Get billing usage data for the authenticated user as a cursor-paginated walk in ascending timestamp order. The first request takes filter parameters; while more entries remain, each response carries a nextCursor token that fetches the next page. A continuation request sends the cursor and nothing else — the filters travel inside the cursor, and filter parameters sent alongside one are rejected. A rejected cursor (expired, tampered with, or issued to another user) yields a 400 response; restart the walk from the first page. Page contents are stable while new usage is recorded, and no result totals are reported. Include text/csv in the Accept header to receive the page as a CSV export instead of JSON.\",\"url\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/de/api-reference/endpoint/billing/usage-history#webpage\"},\"dateModified\":\"2026-07-28T18:41:08.744Z\",\"publisher\":{\"@id\":\"https://docs.venice.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Venice API Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Venice API Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/endpoint/billing/usage-history"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api-reference/endpoint/billing/usage-history"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/api-reference/endpoint/billing/usage-history"}]},{"language":"it","pages":[{"title":"it","href":"/it/api-reference/endpoint/billing/usage-history"}]},{"language":"de","tabs":[{"tab":"Dokumentation","icon":"book","pages":[{"title":"Dokumentation","href":"/de/overview/about-venice"}]},{"tab":"Modelle","icon":"box","pages":[{"title":"Modelle","href":"/de/models/overview"}]},{"tab":"Lernen","icon":"layout-grid","pages":[{"title":"Lernen","href":"/de/learn"}]},{"tab":"API-Referenz","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"Einführung","href":"/de/api-reference/api-spec"},{"title":"Rate Limits","href":"/de/api-reference/rate-limiting"},{"title":"Fehlercodes","href":"/de/api-reference/error-codes"},{"group":"Chat","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/de/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/de/api-reference/endpoint/responses/create"},{"title":"Model Feature Suffix","href":"/de/api-reference/endpoint/chat/model_feature_suffix"},{"title":"Entscheidungen erstellen","openapi":"POST /decisions","href":"/de/api-reference/endpoint/decisions/create"},{"title":"System-One-Kompatibilität","openapi":"POST /systemone","href":"/de/api-reference/endpoint/decisions/systemone"}]},{"group":"Bilder","expanded":false,"pages":[{"title":"Bilder generieren","openapi":"POST /image/generate","href":"/de/api-reference/endpoint/image/generate"},{"title":"Upscale und Enhance","openapi":"POST /image/upscale","href":"/de/api-reference/endpoint/image/upscale"},{"title":"Edit (alias Inpaint)","openapi":"POST /image/edit","href":"/de/api-reference/endpoint/image/edit"},{"title":"Multi-Edit Image","openapi":"POST /image/multi-edit","href":"/de/api-reference/endpoint/image/multi-edit"},{"title":"Background Remove","openapi":"POST /image/background-remove","href":"/de/api-reference/endpoint/image/background-remove"},{"title":"Image Styles","openapi":"GET /image/styles","href":"/de/api-reference/endpoint/image/styles"},{"title":"Bilder generieren (OpenAI-kompatible API)","openapi":"POST /images/generations","href":"/de/api-reference/endpoint/image/generations"}]},{"group":"Audio","expanded":false,"pages":[{"title":"Speech API (Beta)","openapi":"POST /audio/speech","href":"/de/api-reference/endpoint/audio/speech"},{"title":"Stimme klonen","openapi":"POST /audio/voices","href":"/de/api-reference/endpoint/audio/voices"},{"title":"Transcriptions API (Beta)","openapi":"POST /audio/transcriptions","href":"/de/api-reference/endpoint/audio/transcriptions"},{"title":"Audio-Generierung in die Warteschlange einreihen","openapi":"POST /audio/queue","href":"/de/api-reference/endpoint/audio/queue"},{"title":"Audio abrufen","openapi":"POST /audio/retrieve","href":"/de/api-reference/endpoint/audio/retrieve"},{"title":"Audio-Generierung kalkulieren","openapi":"POST /audio/quote","href":"/de/api-reference/endpoint/audio/quote"},{"title":"Audio abschließen","openapi":"POST /audio/complete","href":"/de/api-reference/endpoint/audio/complete"},{"title":"Voice Changer in die Warteschlange einreihen","openapi":"POST /audio/voice-changer/queue","href":"/de/api-reference/endpoint/audio/voice-changer/queue"},{"title":"Voice Changer abrufen","openapi":"POST /audio/voice-changer/retrieve","href":"/de/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"Voice Changer kalkulieren","openapi":"POST /audio/voice-changer/quote","href":"/de/api-reference/endpoint/audio/voice-changer/quote"},{"title":"Voice Changer abschließen","openapi":"POST /audio/voice-changer/complete","href":"/de/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"Video","expanded":false,"pages":[{"title":"Videogenerierung in die Warteschlange stellen","openapi":"POST /video/queue","href":"/de/api-reference/endpoint/video/queue"},{"title":"Video abrufen","openapi":"POST /video/retrieve","href":"/de/api-reference/endpoint/video/retrieve"},{"title":"Video-Generierung kalkulieren","openapi":"POST /video/quote","href":"/de/api-reference/endpoint/video/quote"},{"title":"Video abschließen","openapi":"POST /video/complete","href":"/de/api-reference/endpoint/video/complete"}]},{"group":"Tools","expanded":false,"pages":[{"title":"Text Parser","openapi":"POST /augment/text-parser","href":"/de/api-reference/endpoint/augment/text-parser"},{"title":"Web Scrape","openapi":"POST /augment/scrape","href":"/de/api-reference/endpoint/augment/scrape"},{"title":"Web Search","openapi":"POST /augment/search","href":"/de/api-reference/endpoint/augment/search"},{"title":"Crypto Networks","openapi":"GET /crypto/rpc/networks","href":"/de/api-reference/endpoint/crypto/networks"},{"title":"Crypto RPC","openapi":"POST /crypto/rpc/{network}","href":"/de/api-reference/endpoint/crypto/rpc"}]},{"group":"Embeddings","expanded":false,"pages":[{"title":"Embeddings generieren","openapi":"POST /embeddings","href":"/de/api-reference/endpoint/embeddings/generate"}]},{"group":"Modelle","expanded":false,"pages":[{"title":"Modelle auflisten","openapi":"GET /models","href":"/de/api-reference/endpoint/models/list"},{"title":"Compatibility Mapping","openapi":"GET /models/compatibility_mapping","href":"/de/api-reference/endpoint/models/compatibility_mapping"},{"title":"Traits","openapi":"GET /models/traits","href":"/de/api-reference/endpoint/models/traits"}]},{"group":"API-Schlüssel","expanded":false,"pages":[{"title":"API-Schlüssel auflisten","openapi":"GET /api_keys","href":"/de/api-reference/endpoint/api_keys/list"},{"title":"Details zum API-Schlüssel abrufen","openapi":"GET /api_keys/{id}","href":"/de/api-reference/endpoint/api_keys/get"},{"title":"API-Schlüssel erstellen","openapi":"POST /api_keys","href":"/de/api-reference/endpoint/api_keys/create"},{"title":"API-Schlüssel aktualisieren","openapi":"PATCH /api_keys","href":"/de/api-reference/endpoint/api_keys/update"},{"title":"API-Schlüssel löschen","openapi":"DELETE /api_keys","href":"/de/api-reference/endpoint/api_keys/delete"},{"title":"API-Schlüssel mit Web3-Wallet generieren","openapi":"GET /api_keys/generate_web3_key","href":"/de/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"API-Schlüssel mit Web3-Wallet generieren","openapi":"POST /api_keys/generate_web3_key","href":"/de/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"API-Schlüssel-Limits","expanded":false,"pages":[{"title":"Rate-Limits und Guthaben","openapi":"GET /api_keys/rate_limits","href":"/de/api-reference/endpoint/api_keys/rate_limits"},{"title":"Rate-Limit-Logs","openapi":"GET /api_keys/rate_limits/log","href":"/de/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"Charaktere","expanded":false,"pages":[{"title":"Character abrufen","openapi":"GET /characters/{slug}","href":"/de/api-reference/endpoint/characters/get"},{"title":"Characters auflisten","openapi":"GET /characters","href":"/de/api-reference/endpoint/characters/list"},{"title":"Character-Bewertungen auflisten","openapi":"GET /characters/{slug}/reviews","href":"/de/api-reference/endpoint/characters/reviews"}]},{"group":"Abrechnung","expanded":false,"pages":[{"title":"Billing Balance","openapi":"GET /billing/balance","href":"/de/api-reference/endpoint/billing/balance"},{"title":"Abrechnungsnutzung (entfernt)","openapi":"GET /billing/usage","href":"/de/api-reference/endpoint/billing/usage"},{"title":"Billing Usage Analytics (Beta)","openapi":"GET /billing/usage-analytics","description":"**Beta**: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.\n\nGet aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.","href":"/de/api-reference/endpoint/billing/usage-analytics"},{"title":"Abrechnungsnutzungsverlauf","openapi":"GET /billing/usage-history","href":"/de/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"X402 Balance","openapi":"GET /x402/balance/{walletAddress}","description":"Get the x402 credit balance for a wallet address. Requires Sign-in-with-x authentication for the same EVM or Solana wallet.","href":"/de/api-reference/endpoint/x402/balance"},{"title":"X402 Top Up","openapi":"POST /x402/top-up","href":"/de/api-reference/endpoint/x402/top-up"},{"title":"X402 Transactions","openapi":"GET /x402/transactions/{walletAddress}","href":"/de/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"Änderungen","icon":"history","href":"https://venice.ai/changelog"},{"tab":"Status","icon":"activity","href":"https://veniceai-status.com"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/endpoint/billing/usage-history"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/endpoint/billing/usage-history"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/endpoint/billing/usage-history"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/endpoint/billing/usage-history"}]}]},"basePath":"","title":"Abrechnungsnutzungsverlauf | Venice API-Dokumentation","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-Dr40SSJq.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}