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":""},"chroma":{"liveDeploymentHistoryId":"6aecc984cead53540b340f51","collectionId":"99b90f4c-705d-4e93-87b7-a51647e3c680","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecc984cead53540b340f51"},"feedback":{"edits":true,"issues":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aee834c3c207e14f3cabebd","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"en","tag":"Models","count":562},{"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":"ar/api-reference/endpoint/billing/usage-history","slug":"/ar/api-reference/endpoint/billing/usage-history","pageMetadata":{"title":"سجل استخدام الفوترة","openapi":"GET /billing/usage-history","og:title":"سجل استخدام الفوترة | وثائق واجهة برمجة تطبيقات Venice","og:description":"تصفح إدخالات استخدام الفوترة الخاصة بك باستخدام ترقيم صفحات مستقر يعتمد على المؤشر.","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":"/ar/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":"سجل استخدام الفوترة","openapi":"GET /billing/usage-history","og:title":"سجل استخدام الفوترة | وثائق واجهة برمجة تطبيقات Venice","og:description":"تصفح إدخالات استخدام الفوترة الخاصة بك باستخدام ترقيم صفحات مستقر يعتمد على المؤشر.","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":"/ar/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":["8622eab2-6ac3-4f32-8ac2-962463d396cb","059d31a1-79b2-40cd-8627-a8ed4e068571","672cbdb9-8447-4218-80a3-346e6eb8cf1d","f4dd61af-cb86-4303-bdb8-5b56b6142345","48955475-7273-4dbb-b283-474c5d479908"],"responses":{"200":"4b9e51d9-f976-4a62-889c-816075908266","400":"d84bf98b-bdb9-4e84-899f-554ae38fa7f6","401":"00913044-8b8d-465f-9f46-02fd946f1a1a","403":"19f35249-9e16-44e0-b283-316bdeb0ffc5","500":"d2170cf4-9ec2-4d68-b92d-3f29a0d2792f"},"method":"get","type":"path","servers":["2d1ade57-9bc2-4690-b538-768423923d2d"],"security":["3199a56f-96d2-4251-bbf1-17716fd5ece4"],"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":{"8622eab2-6ac3-4f32-8ac2-962463d396cb":{"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"},"059d31a1-79b2-40cd-8627-a8ed4e068571":{"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"},"672cbdb9-8447-4218-80a3-346e6eb8cf1d":{"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"},"f4dd61af-cb86-4303-bdb8-5b56b6142345":{"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"},"48955475-7273-4dbb-b283-474c5d479908":{"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":{"4b9e51d9-f976-4a62-889c-816075908266":{"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"},"d84bf98b-bdb9-4e84-899f-554ae38fa7f6":{"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"},"00913044-8b8d-465f-9f46-02fd946f1a1a":{"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"},"19f35249-9e16-44e0-b283-316bdeb0ffc5":{"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"},"d2170cf4-9ec2-4d68-b92d-3f29a0d2792f":{"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":{"3199a56f-96d2-4251-bbf1-17716fd5ece4":{"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"2d1ade57-9bc2-4690-b538-768423923d2d":{"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":"سجل استخدام الفوترة | وثائق واجهة برمجة تطبيقات 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":1},"ar":{"href":"/ar/api-reference/endpoint/billing/usage-history","matchLevel":0},"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:08.868Z","originalFileLocation":"ar/api-reference/endpoint/billing/usage-history.mdx","locale":"ar"},"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=\"سجل استخدام الفوترة | وثائق واجهة برمجة تطبيقات Venice\">\u003cmeta data-mint-head property=\"og:description\" content=\"تصفح إدخالات استخدام الفوترة الخاصة بك باستخدام ترقيم صفحات مستقر يعتمد على المؤشر.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Venice API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venice.ai/ar/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=%D8%A7%D9%84%D9%81%D9%88%D8%AA%D8%B1%D8%A9\u0026amp;title=%D8%B3%D8%AC%D9%84+%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85+%D8%A7%D9%84%D9%81%D9%88%D8%AA%D8%B1%D8%A9\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=6dae94e462afee8c19bf9d289ab72b1b93630f1197ef62af350f8ebc378a4a15\">\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=\"سجل استخدام الفوترة | وثائق واجهة برمجة تطبيقات Venice\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"تصفح إدخالات استخدام الفوترة الخاصة بك باستخدام ترقيم صفحات مستقر يعتمد على المؤشر.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.site/_mintlify/api/og/v2?division=%D8%A7%D9%84%D9%81%D9%88%D8%AA%D8%B1%D8%A9\u0026amp;title=%D8%B3%D8%AC%D9%84+%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85+%D8%A7%D9%84%D9%81%D9%88%D8%AA%D8%B1%D8%A9\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=6dae94e462afee8c19bf9d289ab72b1b93630f1197ef62af350f8ebc378a4a15\">\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/ar/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=\"/ar/api-reference/endpoint/billing/usage-history.md\">\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=\"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=\"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/ar/api-reference/endpoint/billing/usage-history#webpage\",\"url\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-history\",\"name\":\"سجل استخدام الفوترة\",\"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.868Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/ar/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"الفوترة\",\"item\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/balance\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"سجل استخدام الفوترة\",\"item\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-history\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-history#apireference\",\"headline\":\"سجل استخدام الفوترة\",\"name\":\"سجل استخدام الفوترة\",\"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/ar/api-reference/endpoint/billing/usage-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/ar/api-reference/endpoint/billing/usage-history#webpage\"},\"dateModified\":\"2026-07-28T18:41:08.868Z\",\"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","tabs":[{"tab":"التوثيق","icon":"book","pages":[{"title":"التوثيق","href":"/ar/overview/about-venice"}]},{"tab":"النماذج","icon":"box","pages":[{"title":"النماذج","href":"/ar/models/overview"}]},{"tab":"تعلّم","icon":"layout-grid","pages":[{"title":"تعلّم","href":"/ar/learn"}]},{"tab":"مرجع الـ API","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"مقدمة","href":"/ar/api-reference/api-spec"},{"title":"حدود المعدل","href":"/ar/api-reference/rate-limiting"},{"title":"رموز الأخطاء","href":"/ar/api-reference/error-codes"},{"group":"الدردشة","expanded":false,"pages":[{"title":"إكمال المحادثات","openapi":"POST /chat/completions","href":"/ar/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/ar/api-reference/endpoint/responses/create"},{"title":"لاحقة ميزات النموذج","href":"/ar/api-reference/endpoint/chat/model_feature_suffix"},{"title":"إنشاء القرارات","openapi":"POST /decisions","href":"/ar/api-reference/endpoint/decisions/create"},{"title":"التوافق مع System One","openapi":"POST /systemone","href":"/ar/api-reference/endpoint/decisions/systemone"}]},{"group":"الصور","expanded":false,"pages":[{"title":"توليد الصور","openapi":"POST /image/generate","href":"/ar/api-reference/endpoint/image/generate"},{"title":"تكبير الصور وتحسينها","openapi":"POST /image/upscale","href":"/ar/api-reference/endpoint/image/upscale"},{"title":"تحرير (المعروف بـ Inpaint)","openapi":"POST /image/edit","href":"/ar/api-reference/endpoint/image/edit"},{"title":"تحرير الصور المتعدد","openapi":"POST /image/multi-edit","href":"/ar/api-reference/endpoint/image/multi-edit"},{"title":"إزالة الخلفية","openapi":"POST /image/background-remove","href":"/ar/api-reference/endpoint/image/background-remove"},{"title":"أنماط الصور","openapi":"GET /image/styles","href":"/ar/api-reference/endpoint/image/styles"},{"title":"توليد الصور (واجهة متوافقة مع OpenAI)","openapi":"POST /images/generations","href":"/ar/api-reference/endpoint/image/generations"}]},{"group":"الصوت","expanded":false,"pages":[{"title":"واجهة Speech API (تجريبية)","openapi":"POST /audio/speech","href":"/ar/api-reference/endpoint/audio/speech"},{"title":"استنساخ الصوت","openapi":"POST /audio/voices","href":"/ar/api-reference/endpoint/audio/voices"},{"title":"واجهة Transcriptions API (تجريبية)","openapi":"POST /audio/transcriptions","href":"/ar/api-reference/endpoint/audio/transcriptions"},{"title":"وضع توليد الصوت في قائمة الانتظار","openapi":"POST /audio/queue","href":"/ar/api-reference/endpoint/audio/queue"},{"title":"استرجاع الصوت","openapi":"POST /audio/retrieve","href":"/ar/api-reference/endpoint/audio/retrieve"},{"title":"تسعير توليد الصوت","openapi":"POST /audio/quote","href":"/ar/api-reference/endpoint/audio/quote"},{"title":"إكمال الصوت","openapi":"POST /audio/complete","href":"/ar/api-reference/endpoint/audio/complete"},{"title":"وضع تغيير الصوت في قائمة الانتظار","openapi":"POST /audio/voice-changer/queue","href":"/ar/api-reference/endpoint/audio/voice-changer/queue"},{"title":"استرجاع تغيير الصوت","openapi":"POST /audio/voice-changer/retrieve","href":"/ar/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"تسعير تغيير الصوت","openapi":"POST /audio/voice-changer/quote","href":"/ar/api-reference/endpoint/audio/voice-changer/quote"},{"title":"إكمال تغيير الصوت","openapi":"POST /audio/voice-changer/complete","href":"/ar/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"الفيديو","expanded":false,"pages":[{"title":"وضع توليد الفيديو في قائمة الانتظار","openapi":"POST /video/queue","href":"/ar/api-reference/endpoint/video/queue"},{"title":"استرجاع الفيديو","openapi":"POST /video/retrieve","href":"/ar/api-reference/endpoint/video/retrieve"},{"title":"تسعير توليد الفيديو","openapi":"POST /video/quote","href":"/ar/api-reference/endpoint/video/quote"},{"title":"إكمال الفيديو","openapi":"POST /video/complete","href":"/ar/api-reference/endpoint/video/complete"}]},{"group":"الأدوات","expanded":false,"pages":[{"title":"محلِّل النصوص","openapi":"POST /augment/text-parser","href":"/ar/api-reference/endpoint/augment/text-parser"},{"title":"استخراج محتوى الويب","openapi":"POST /augment/scrape","href":"/ar/api-reference/endpoint/augment/scrape"},{"title":"البحث في الويب","openapi":"POST /augment/search","href":"/ar/api-reference/endpoint/augment/search"},{"title":"شبكات Crypto","openapi":"GET /crypto/rpc/networks","href":"/ar/api-reference/endpoint/crypto/networks"},{"title":"Crypto RPC","openapi":"POST /crypto/rpc/{network}","href":"/ar/api-reference/endpoint/crypto/rpc"}]},{"group":"التضمينات","expanded":false,"pages":[{"title":"إنشاء Embeddings","openapi":"POST /embeddings","href":"/ar/api-reference/endpoint/embeddings/generate"}]},{"group":"النماذج","expanded":false,"pages":[{"title":"قائمة النماذج","openapi":"GET /models","href":"/ar/api-reference/endpoint/models/list"},{"title":"خريطة التوافق","openapi":"GET /models/compatibility_mapping","href":"/ar/api-reference/endpoint/models/compatibility_mapping"},{"title":"سمات النماذج","openapi":"GET /models/traits","href":"/ar/api-reference/endpoint/models/traits"}]},{"group":"مفاتيح الـ API","expanded":false,"pages":[{"title":"قائمة مفاتيح API","openapi":"GET /api_keys","href":"/ar/api-reference/endpoint/api_keys/list"},{"title":"الحصول على تفاصيل مفتاح API","openapi":"GET /api_keys/{id}","href":"/ar/api-reference/endpoint/api_keys/get"},{"title":"إنشاء مفتاح API","openapi":"POST /api_keys","href":"/ar/api-reference/endpoint/api_keys/create"},{"title":"تحديث مفتاح API","openapi":"PATCH /api_keys","href":"/ar/api-reference/endpoint/api_keys/update"},{"title":"حذف مفتاح API","openapi":"DELETE /api_keys","href":"/ar/api-reference/endpoint/api_keys/delete"},{"title":"إنشاء مفتاح API بمحفظة Web3","openapi":"GET /api_keys/generate_web3_key","href":"/ar/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"إنشاء مفتاح API بمحفظة Web3","openapi":"POST /api_keys/generate_web3_key","href":"/ar/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"حدود معدّل مفاتيح الـ API","expanded":false,"pages":[{"title":"حدود المعدل والأرصدة","openapi":"GET /api_keys/rate_limits","href":"/ar/api-reference/endpoint/api_keys/rate_limits"},{"title":"سجلات حدود المعدل","openapi":"GET /api_keys/rate_limits/log","href":"/ar/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"الشخصيات","expanded":false,"pages":[{"title":"الحصول على شخصية","openapi":"GET /characters/{slug}","href":"/ar/api-reference/endpoint/characters/get"},{"title":"قائمة الشخصيات","openapi":"GET /characters","href":"/ar/api-reference/endpoint/characters/list"},{"title":"قائمة مراجعات الشخصيات","openapi":"GET /characters/{slug}/reviews","href":"/ar/api-reference/endpoint/characters/reviews"}]},{"group":"الفوترة","expanded":false,"pages":[{"title":"رصيد الفوترة","openapi":"GET /billing/balance","href":"/ar/api-reference/endpoint/billing/balance"},{"title":"استخدام الفوترة (أُزيلت)","openapi":"GET /billing/usage","href":"/ar/api-reference/endpoint/billing/usage"},{"title":"تحليلات استخدام الفوترة (بيتا)","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":"/ar/api-reference/endpoint/billing/usage-analytics"},{"title":"سجل استخدام الفوترة","openapi":"GET /billing/usage-history","href":"/ar/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"رصيد 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":"/ar/api-reference/endpoint/x402/balance"},{"title":"شحن رصيد X402","openapi":"POST /x402/top-up","href":"/ar/api-reference/endpoint/x402/top-up"},{"title":"معاملات X402","openapi":"GET /x402/transactions/{walletAddress}","href":"/ar/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"سجل التغييرات","icon":"history","href":"https://venice.ai/changelog"},{"tab":"الحالة","icon":"activity","href":"https://veniceai-status.com"}]},{"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":"سجل استخدام الفوترة | وثائق واجهة برمجة تطبيقات Venice","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BUDYNlhG.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}