{"uid":"cap_7gp9oT7B7DxKdFmrnbEua","slug":"venice-ai-billing-usage-f4c80237","name":"Venice AI Billing Usage","description":"Get paginated billing usage data for the authenticated user. NOTE: This is a beta endpoint and may be subject to change.","url":"https://api.venice.ai/api/v1/billing/usage?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","default":1,"example":1,"minimum":0,"description":"Page number for pagination","exclusiveMinimum":true},"limit":{"type":"integer","default":200,"example":200,"maximum":500,"minimum":0,"description":"Number of items per page","exclusiveMinimum":true},"endDate":{"type":"string","format":"date-time","example":"2024-01-01","description":"End date for filtering records (ISO 8601)"},"currency":{"enum":["USD","VCU","DIEM","BUNDLED_CREDITS"],"type":"string","example":"USD","description":"Filter by currency"},"sortOrder":{"enum":["asc","desc"],"type":"string","default":"desc","example":"desc","description":"Sort order for createdAt field"},"startDate":{"type":"string","format":"date-time","example":"2024-01-01","description":"Start date for filtering records (ISO 8601)"}}},"responseSchema":{"type":"object","example":{"data":[{"sku":"grok-imagine-image-image-unit","notes":"API Inference","units":1,"amount":-0.1,"currency":"DIEM","timestamp":{},"pricePerUnitUsd":0.1,"inferenceDetails":null},{"sku":"zai-org-glm-5-1-llm-output-mtoken","notes":"API Inference","units":0.000227,"amount":-0.06356,"currency":"DIEM","timestamp":{},"pricePerUnitUsd":2.8,"inferenceDetails":{"requestId":"chatcmpl-4007fd29f42b7d3c4107f4345e8d174a","promptTokens":339,"completionTokens":227,"inferenceExecutionTime":2964}}],"pagination":{"page":200,"limit":1,"total":56090,"totalPages":56090}},"required":["data","pagination"],"properties":{"data":{"type":"array","items":{"type":"object","required":["amount","currency","inferenceDetails","notes","pricePerUnitUsd","sku","timestamp","units"],"properties":{"sku":{"type":"string","description":"The product associated with the billing usage entry"},"notes":{"type":"string","description":"Notes about the billing usage entry"},"units":{"type":"number","description":"The number of units consumed"},"amount":{"type":"number","description":"The total amount charged for the billing usage entry"},"currency":{"enum":["USD","VCU","DIEM","BUNDLED_CREDITS"],"type":"string","example":"USD","description":"The currency charged for the billing usage entry"},"timestamp":{"type":"string","example":"2025-01-01T00:00:00.000Z","description":"The timestamp the billing usage entry was created"},"pricePerUnitUsd":{"type":"number","description":"The price per unit in USD"},"inferenceDetails":{"type":"object","nullable":true,"required":["completionTokens","inferenceExecutionTime","promptTokens","requestId"],"properties":{"requestId":{"type":"string","nullable":true,"description":"Unique identifier for the inference request"},"promptTokens":{"type":"number","nullable":true,"description":"Number of tokens requested in the prompt. Only present for LLM usage."},"completionTokens":{"type":"number","nullable":true,"description":"Number of tokens used in the completion. Only present for LLM usage."},"inferenceExecutionTime":{"type":"number","nullable":true,"description":"Time taken for inference execution in milliseconds"}},"description":"Details about the related inference request, if applicable"}}}},"pagination":{"type":"object","required":["limit","page","total","totalPages"],"properties":{"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"totalPages":{"type":"number"}}},"warningMessage":{"type":"string","description":"A warning message to disambiguate DIEM usage from legacy DIEM (formerly VCU) usage"}},"description":"The response schema for the billing usage endpoint","additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402","ai_ml"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9_KOG5w7gOA-uJI2qiUvb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves paginated billing usage records for the authenticated Venice AI user, with filtering by date range and currency.","exampleAgentPrompt":"Show me my Venice AI billing usage for January 2024 — page 1 with 200 records per page, filtered to USD charges and sorted from newest to oldest.","exampleUseCases":null,"resultDescription":"Returns an array of billing usage entries, each containing SKU, notes, units consumed, amount charged, currency (USD/VCU/DIEM/BUNDLED_CREDITS), timestamp, price per unit in USD, and optional inference details (requestId, promptTokens, completionTokens, executionTime). Also returns pagination metadata including current page, limit, total records, and total pages.","failureModes":["Invalid date format returns 400 — use ISO 8601 format for startDate/endDate","Page or limit below minimum (0) returns validation error","Invalid currency enum value returns 400","Unauthenticated request returns 401","Rate limit exceeded returns 429","Beta endpoint may return unexpected schema changes or 5xx errors"],"whenToPreferThis":"Use this endpoint when you need detailed per-call billing records including SKU-level breakdowns, token counts, and inference execution times for the authenticated Venice AI account. Prefer this over the Usage Analytics sibling endpoint when you need raw paginated data rather than aggregated analytics, or when you need to export or audit specific date ranges of usage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T22:27:24.150Z","isFirstParty":false,"canonicalSlug":"venice-ai-billing-usage-f4c80237"}