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":"6af030f5e61eac68d6d67603","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":"pt-BR/api-reference/endpoint/billing/usage-history","slug":"/pt-BR/api-reference/endpoint/billing/usage-history","pageMetadata":{"title":"Histórico de uso de faturamento","openapi":"GET /billing/usage-history","og:title":"Histórico de uso de faturamento | Documentação da API Venice","og:description":"Percorra suas entradas de uso de faturamento com paginação estável baseada em cursor.","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":"/pt-BR/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":"Histórico de uso de faturamento","openapi":"GET /billing/usage-history","og:title":"Histórico de uso de faturamento | Documentação da API Venice","og:description":"Percorra suas entradas de uso de faturamento com paginação estável baseada em cursor.","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":"/pt-BR/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":"Histórico de uso de faturamento | Documentação da API Venice","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":0},"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":1},"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:07.757Z","originalFileLocation":"pt-BR/api-reference/endpoint/billing/usage-history.mdx","locale":"pt-BR"},"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=\"Histórico de uso de faturamento | Documentação da API Venice\">\u003cmeta data-mint-head property=\"og:description\" content=\"Percorra suas entradas de uso de faturamento com paginação estável baseada em cursor.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Venice API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venice.ai/pt-BR/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=Faturamento\u0026amp;title=Hist%C3%B3rico+de+uso+de+faturamento\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=469d55248e21f3f9930db4d4ece876e083fc263d40b5a86d362a9d9352c50fcb\">\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=\"Histórico de uso de faturamento | Documentação da API Venice\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Percorra suas entradas de uso de faturamento com paginação estável baseada em cursor.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.site/_mintlify/api/og/v2?division=Faturamento\u0026amp;title=Hist%C3%B3rico+de+uso+de+faturamento\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=469d55248e21f3f9930db4d4ece876e083fc263d40b5a86d362a9d9352c50fcb\">\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/pt-BR/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=\"/pt-BR/api-reference/endpoint/billing/usage-history.md\">\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=\"en\" href=\"https://docs.venice.ai/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=\"de\" href=\"https://docs.venice.ai/de/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/pt-BR/api-reference/endpoint/billing/usage-history#webpage\",\"url\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-history\",\"name\":\"Histórico de uso de faturamento\",\"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:07.757Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/pt-BR/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Faturamento\",\"item\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/balance\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Histórico de uso de faturamento\",\"item\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-history\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-history#apireference\",\"headline\":\"Histórico de uso de faturamento\",\"name\":\"Histórico de uso de faturamento\",\"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/pt-BR/api-reference/endpoint/billing/usage-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/pt-BR/api-reference/endpoint/billing/usage-history#webpage\"},\"dateModified\":\"2026-07-28T18:41:07.757Z\",\"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","tabs":[{"tab":"Documentação","icon":"book","pages":[{"title":"Documentação","href":"/pt-BR/overview/about-venice"}]},{"tab":"Modelos","icon":"box","pages":[{"title":"Modelos","href":"/pt-BR/models/overview"}]},{"tab":"Aprender","icon":"layout-grid","pages":[{"title":"Aprender","href":"/pt-BR/learn"}]},{"tab":"Referência da API","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"Introdução","href":"/pt-BR/api-reference/api-spec"},{"title":"Limites de taxa","href":"/pt-BR/api-reference/rate-limiting"},{"title":"Códigos de erro","href":"/pt-BR/api-reference/error-codes"},{"group":"Chat","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/pt-BR/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/pt-BR/api-reference/endpoint/responses/create"},{"title":"Sufixo de recursos do modelo","href":"/pt-BR/api-reference/endpoint/chat/model_feature_suffix"},{"title":"Criar decisões","openapi":"POST /decisions","href":"/pt-BR/api-reference/endpoint/decisions/create"},{"title":"Compatibilidade com System One","openapi":"POST /systemone","href":"/pt-BR/api-reference/endpoint/decisions/systemone"}]},{"group":"Imagens","expanded":false,"pages":[{"title":"Gerar imagens","openapi":"POST /image/generate","href":"/pt-BR/api-reference/endpoint/image/generate"},{"title":"Upscale e enhance","openapi":"POST /image/upscale","href":"/pt-BR/api-reference/endpoint/image/upscale"},{"title":"Editar (também conhecido como inpaint)","openapi":"POST /image/edit","href":"/pt-BR/api-reference/endpoint/image/edit"},{"title":"Edição múltipla de imagem","openapi":"POST /image/multi-edit","href":"/pt-BR/api-reference/endpoint/image/multi-edit"},{"title":"Remover plano de fundo","openapi":"POST /image/background-remove","href":"/pt-BR/api-reference/endpoint/image/background-remove"},{"title":"Estilos de imagem","openapi":"GET /image/styles","href":"/pt-BR/api-reference/endpoint/image/styles"},{"title":"Gerar imagens (API compatível com OpenAI)","openapi":"POST /images/generations","href":"/pt-BR/api-reference/endpoint/image/generations"}]},{"group":"Áudio","expanded":false,"pages":[{"title":"API de fala (Beta)","openapi":"POST /audio/speech","href":"/pt-BR/api-reference/endpoint/audio/speech"},{"title":"Clonar voz","openapi":"POST /audio/voices","href":"/pt-BR/api-reference/endpoint/audio/voices"},{"title":"API de transcrições (Beta)","openapi":"POST /audio/transcriptions","href":"/pt-BR/api-reference/endpoint/audio/transcriptions"},{"title":"Enfileirar geração de áudio","openapi":"POST /audio/queue","href":"/pt-BR/api-reference/endpoint/audio/queue"},{"title":"Recuperar áudio","openapi":"POST /audio/retrieve","href":"/pt-BR/api-reference/endpoint/audio/retrieve"},{"title":"Cotação de geração de áudio","openapi":"POST /audio/quote","href":"/pt-BR/api-reference/endpoint/audio/quote"},{"title":"Concluir áudio","openapi":"POST /audio/complete","href":"/pt-BR/api-reference/endpoint/audio/complete"},{"title":"Enfileirar trocador de voz","openapi":"POST /audio/voice-changer/queue","href":"/pt-BR/api-reference/endpoint/audio/voice-changer/queue"},{"title":"Recuperar trocador de voz","openapi":"POST /audio/voice-changer/retrieve","href":"/pt-BR/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"Cotação do trocador de voz","openapi":"POST /audio/voice-changer/quote","href":"/pt-BR/api-reference/endpoint/audio/voice-changer/quote"},{"title":"Concluir trocador de voz","openapi":"POST /audio/voice-changer/complete","href":"/pt-BR/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"Vídeo","expanded":false,"pages":[{"title":"Enfileirar Geração de Vídeo","openapi":"POST /video/queue","href":"/pt-BR/api-reference/endpoint/video/queue"},{"title":"Recuperar vídeo","openapi":"POST /video/retrieve","href":"/pt-BR/api-reference/endpoint/video/retrieve"},{"title":"Cotação de geração de vídeo","openapi":"POST /video/quote","href":"/pt-BR/api-reference/endpoint/video/quote"},{"title":"Concluir vídeo","openapi":"POST /video/complete","href":"/pt-BR/api-reference/endpoint/video/complete"}]},{"group":"Ferramentas","expanded":false,"pages":[{"title":"Text Parser","openapi":"POST /augment/text-parser","href":"/pt-BR/api-reference/endpoint/augment/text-parser"},{"title":"Web Scrape","openapi":"POST /augment/scrape","href":"/pt-BR/api-reference/endpoint/augment/scrape"},{"title":"Web Search","openapi":"POST /augment/search","href":"/pt-BR/api-reference/endpoint/augment/search"},{"title":"Redes cripto","openapi":"GET /crypto/rpc/networks","href":"/pt-BR/api-reference/endpoint/crypto/networks"},{"title":"Crypto RPC","openapi":"POST /crypto/rpc/{network}","href":"/pt-BR/api-reference/endpoint/crypto/rpc"}]},{"group":"Embeddings","expanded":false,"pages":[{"title":"Gerar embeddings","openapi":"POST /embeddings","href":"/pt-BR/api-reference/endpoint/embeddings/generate"}]},{"group":"Modelos","expanded":false,"pages":[{"title":"Listar modelos","openapi":"GET /models","href":"/pt-BR/api-reference/endpoint/models/list"},{"title":"Mapeamento de compatibilidade","openapi":"GET /models/compatibility_mapping","href":"/pt-BR/api-reference/endpoint/models/compatibility_mapping"},{"title":"Atributos","openapi":"GET /models/traits","href":"/pt-BR/api-reference/endpoint/models/traits"}]},{"group":"Chaves de API","expanded":false,"pages":[{"title":"Listar chaves de API","openapi":"GET /api_keys","href":"/pt-BR/api-reference/endpoint/api_keys/list"},{"title":"Obter detalhes da chave de API","openapi":"GET /api_keys/{id}","href":"/pt-BR/api-reference/endpoint/api_keys/get"},{"title":"Criar chave de API","openapi":"POST /api_keys","href":"/pt-BR/api-reference/endpoint/api_keys/create"},{"title":"Atualizar chave de API","openapi":"PATCH /api_keys","href":"/pt-BR/api-reference/endpoint/api_keys/update"},{"title":"Excluir chave de API","openapi":"DELETE /api_keys","href":"/pt-BR/api-reference/endpoint/api_keys/delete"},{"title":"Gerar chave de API com carteira Web3","openapi":"GET /api_keys/generate_web3_key","href":"/pt-BR/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"Gerar chave de API com carteira Web3","openapi":"POST /api_keys/generate_web3_key","href":"/pt-BR/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"Limites das chaves de API","expanded":false,"pages":[{"title":"Limites de taxa e saldos","openapi":"GET /api_keys/rate_limits","href":"/pt-BR/api-reference/endpoint/api_keys/rate_limits"},{"title":"Logs de limite de taxa","openapi":"GET /api_keys/rate_limits/log","href":"/pt-BR/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"Personagens","expanded":false,"pages":[{"title":"Obter personagem","openapi":"GET /characters/{slug}","href":"/pt-BR/api-reference/endpoint/characters/get"},{"title":"Listar personagens","openapi":"GET /characters","href":"/pt-BR/api-reference/endpoint/characters/list"},{"title":"Listar avaliações de personagens","openapi":"GET /characters/{slug}/reviews","href":"/pt-BR/api-reference/endpoint/characters/reviews"}]},{"group":"Faturamento","expanded":false,"pages":[{"title":"Saldo de cobrança","openapi":"GET /billing/balance","href":"/pt-BR/api-reference/endpoint/billing/balance"},{"title":"Uso de faturamento (removido)","openapi":"GET /billing/usage","href":"/pt-BR/api-reference/endpoint/billing/usage"},{"title":"Análise de uso de cobrança (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":"/pt-BR/api-reference/endpoint/billing/usage-analytics"},{"title":"Histórico de uso de faturamento","openapi":"GET /billing/usage-history","href":"/pt-BR/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"Saldo X402","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":"/pt-BR/api-reference/endpoint/x402/balance"},{"title":"Recarga X402","openapi":"POST /x402/top-up","href":"/pt-BR/api-reference/endpoint/x402/top-up"},{"title":"Transações X402","openapi":"GET /x402/transactions/{walletAddress}","href":"/pt-BR/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"Alterações","icon":"history","href":"https://venice.ai/changelog"},{"tab":"Status","icon":"activity","href":"https://veniceai-status.com"}]},{"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","pages":[{"title":"de","href":"/de/api-reference/endpoint/billing/usage-history"}]},{"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":"Histórico de uso de faturamento | Documentação da API Venice","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","b0f84f53ff","2b790eda92","a9bb46feb3"],"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"]}