This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.
Code of the usage attribution type to group the usage by. When the type has a parent, filters must include a value of the parent type, so the tree is read one level at a time. Lago tracks up to 100,000 values per type for each customer. Once the type reaches this limit, grouping by it returns a too_many_values validation error, unless filters includes a value of its parent type.
Values of usage attribution types to filter the usage by, keyed by type code, e.g. filters[department]=rnd&filters[model][]=opus&filters[model][]=haiku. Each type accepts up to 20 values, and up to 3 flat types can be filtered on. More than 20 values for a type returns a too_many_values validation error.
Start of the period, in ISO 8601 format. It must be sent together with to_datetime, and the period cannot be longer than 31 days. It is moved to the start of the subscription when earlier.
Code of a charge of the plan to split by charge filter, with one entry per filter in charges_usage. The filters are returned 10 at a time, in the order of the charge, starting at split_filters_offset. The charge must have at least 1 filter, and must be part of charge_codes[] when it is sent. A too_many_filters validation error is returned when the filter values of the charge are too many to match events.
Index of the first filter of the split charge to return, starting at 0. Use it with split_filters_count to page through the filters 10 at a time. It is ignored when split_charge_code is not sent.
Basis of the breakdown. With units, no amount is computed and values are ranked by units, summed across the selected charges. With amount, amounts are computed and values are ranked by amount.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Lago","description":"Developer documentation for Lago, the open-source billing platform for usage metering, subscriptions, invoicing, payments, and revenue operations.","colors":{"primary":"#006CFA","light":"#006CFA","dark":"#006CFA"},"logo":{"light":"https://mintcdn.com/lago-docs/zZSJbpe68PHhSs3x/logo/light.svg?fit=max\u0026auto=format\u0026n=zZSJbpe68PHhSs3x\u0026q=85\u0026s=b4af3001527c985b81858b9a0928534c","dark":"https://mintcdn.com/lago-docs/zZSJbpe68PHhSs3x/logo/dark.svg?fit=max\u0026auto=format\u0026n=zZSJbpe68PHhSs3x\u0026q=85\u0026s=1eb7aacac796b0cc6bf05be790a792b1"},"favicon":"https://mintcdn.com/lago-docs/8N-yOElNGe9jRGG5/favicon.svg?fit=max\u0026auto=format\u0026n=8N-yOElNGe9jRGG5\u0026q=85\u0026s=5c319e58dd9b5c5b8a31cf2ad8009a1c","api":{"openapi":"https://swagger.getlago.com/openapi.yaml","mdx":{"server":"https://api.getlago.com/api/v1"}},"background":{"color":{"light":"#F5F5EF","dark":"#131923"}},"navbar":{"links":[{"href":"https://getlago.com/book-a-demo","label":"Book a Demo"}],"primary":{"type":"button","label":"Get Started","href":"https://getlago.com/book-a-demo"}},"footer":{"socials":{"github":"https://github.com/getlago/lago","slack":"https://getlago.com/slack","x":"https://x.com/getlago","linkedin":"https://www.linkedin.com/company/getlago","youtube":"https://www.youtube.com/channel/UCp6ltp7n3SgDVsmerJ7O7ZA"},"links":[{"header":"Documentation","items":[{"label":"Get started","href":"https://getlago.com/docs/guide/introduction/welcome-to-lago"},{"label":"API reference","href":"https://getlago.com/docs/api-reference/intro"},{"label":"Integrations","href":"https://getlago.com/docs/integrations/introduction"},{"label":"Templates","href":"https://getlago.com/docs/templates/introduction"},{"label":"Changelog","href":"https://getlago.com/docs/changelog/product"},{"label":"FAQ","href":"https://getlago.com/docs/faq/about-lago"}]},{"header":"Developers","items":[{"label":"Developer hub","href":"https://getlago.com/docs/developers"},{"label":"Authentication","href":"https://getlago.com/docs/auth"},{"label":"Webhooks","href":"https://getlago.com/docs/guide/webhooks"},{"label":"SDKs","href":"https://getlago.com/docs/developers"},{"label":"OpenAPI spec","href":"https://swagger.getlago.com/"},{"label":"MCP server","href":"https://getlago.com/docs/guide/ai-agents/mcp-server"},{"label":"Self-hosted","href":"https://getlago.com/docs/guide/lago-self-hosted/overview"},{"label":"llms.txt","href":"https://getlago.com/docs/llms.txt"}]},{"header":"Platform","items":[{"label":"Usage metering","href":"https://getlago.com/platform/usage-metering"},{"label":"Billing \u0026 invoicing","href":"https://getlago.com/platform/billing-invoicing"},{"label":"Cash collection","href":"https://getlago.com/platform/cash-collection"},{"label":"Revenue analytics","href":"https://getlago.com/platform/revenue-analytics"},{"label":"Entitlements","href":"https://getlago.com/platform/entitlements"},{"label":"Lago AI","href":"https://getlago.com/platform/ai"},{"label":"Pricing","href":"https://getlago.com/pricing"}]},{"header":"Company","items":[{"label":"About Lago","href":"https://getlago.com/docs/about"},{"label":"Customers","href":"https://getlago.com/customers"},{"label":"Blog","href":"https://getlago.com/blog"},{"label":"Contact","href":"https://getlago.com/docs/contact"},{"label":"Trust center","href":"https://security.getlago.com"},{"label":"Status","href":"https://status.getlago.com"}]}]},"seo":{"metatags":{"canonical":"https://getlago.com/docs","description":"Developer documentation for Lago's API-first billing platform, including OpenAPI, SDKs, webhooks, MCP, authentication, and implementation guides.","keywords":"Lago API, billing API, usage metering API, OpenAPI, billing SDK, Lago MCP"},"organization":{"id":"https://getlago.com/#organization","name":"Lago","legalName":"Get Lago Corp.","url":"https://getlago.com","logo":"https://getlago.com/docs/logo/light.svg","sameAs":["https://github.com/getlago","https://www.linkedin.com/company/getlago","https://x.com/GetLago","https://www.youtube.com/channel/UCp6ltp7n3SgDVsmerJ7O7ZA"]},"indexing":"all"},"fonts":{"heading":{"family":"GT America","weight":700,"source":"fonts/GT-America-Standard-Medium.woff2","format":"woff2"},"body":{"family":"GT America","source":"fonts/GT-America-Standard-Regular.woff2","format":"woff2"}},"styling":{"codeblocks":"dark","latex":true},"integrations":{"ga4":{"measurementId":"G-743BQ9THCG"},"cookies":{"key":"lago_docs_analytics","value":"granted"}},"errors":{"404":{"redirect":false,"title":"Documentation page not found","description":"No Lago documentation exists at this URL. Start at [Lago Developer Documentation](/welcome), browse [Developer Resources](/developers), inspect the [documentation index](/llms.txt) or [sitemap](/sitemap.xml), or search the [API reference](/api-reference/intro)."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://getlago.com/blog"},{"anchor":"Community","icon":"slack","href":"https://getlago.com/slack"},{"anchor":"GitHub","icon":"github","href":"https://github.com/getlago/lago"},{"anchor":"Status","icon":"signal-bars","href":"https://status.getlago.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lago-docs","hasAudioNarration":false,"actualSubdomain":"lago-docs","customDomains":["getlago.com"],"gitSource":{"type":"github","owner":"getlago","repo":"lago-doc","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3359be5e36dceb06587ff","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API References","count":235},{"language":"default","tag":"API Reference","count":235},{"language":"default","tag":"Guide","count":206},{"language":"default","tag":"Integrations","count":54},{"language":"default","tag":"Plans","count":46},{"language":"default","tag":"Resources","count":46},{"language":"default","tag":"Charges","count":39},{"language":"default","tag":"Pricing \u0026 Subscriptions","count":35},{"language":"default","tag":"Subscriptions","count":31},{"language":"default","tag":"Invoices","count":27}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html{visibility:hidden;background-color:#F5F5EF}@media (prefers-color-scheme: dark){html{background-color:#131923}}html.ready{visibility:visible}.dark .welcome-card{background-color:#1c2535!important;border-color:rgba(255, 255, 255, 0.1)!important;box-shadow:0 1px 2px 0 rgba(0, 0, 0, 0.3)!important;color:#e5e7eb}.dark .welcome-card:hover{background-color:#243044!important}.dark .welcome-card h3{color:#ffffff}.dark .welcome-card p{color:#9ca3af!important}#changelog-month-nav{padding-left:2.5rem;width:19rem;box-sizing:border-box;margin-bottom:1.75rem;max-height:45vh;overflow-y:auto}#changelog-month-nav .changelog-month-nav__year{margin:0 0 0.5rem;font-size:0.875rem;line-height:1.5rem;font-weight:500;color:#364152}#changelog-month-nav .changelog-month-nav__list{list-style:none;margin:0;padding:0;border-left:1px solid rgba(0, 0, 0, 0.08)}#changelog-month-nav .changelog-month-nav__list a{display:block;padding:0.25rem 0 0.25rem 0.75rem;margin-left:-1px;border-left:1px solid transparent;font-size:0.875rem;line-height:1.5rem;color:#697586;text-decoration:none;transition:color 0.15s ease, border-color 0.15s ease}#changelog-month-nav .changelog-month-nav__list a:hover{color:#121926}#changelog-month-nav .changelog-month-nav__list a.is-active{color:#006CFA;border-left-color:#006CFA;font-weight:500}.dark #changelog-month-nav .changelog-month-nav__year{color:#cdd5df}.dark #changelog-month-nav .changelog-month-nav__list{border-left-color:rgba(255, 255, 255, 0.12)}.dark #changelog-month-nav .changelog-month-nav__list a{color:#9aa4b2}.dark #changelog-month-nav .changelog-month-nav__list a:hover{color:#ffffff}.dark #changelog-month-nav .changelog-month-nav__list a.is-active{color:#4d9bff;border-left-color:#4d9bff}.update-container>div:first-child{display:none}.update-container>div:nth-child(2){flex:1 1 100%;max-width:100%;width:100%}.update-container{gap:0}#footer a[href*=\"utm_campaign=poweredBy\"]{display:none}"}],"page":{"pagePath":"api-reference/governance/get-attributed-usage","slug":"/api-reference/governance/get-attributed-usage","pageMetadata":{"openapi":"GET /customers/{external_customer_id}/attributed_usage","authMethod":"bearer","title":"Retrieve attributed usage","description":"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.","href":"/api-reference/governance/get-attributed-usage"},"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: \"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.\"\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":"dark","config":{},"pageMetadata":{"openapi":"GET /customers/{external_customer_id}/attributed_usage","authMethod":"bearer","title":"Retrieve attributed usage","description":"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.","href":"/api-reference/governance/get-attributed-usage"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/lago-docs/a0e77058367d9146/canonical.js","/docs/_mintlify/custom/lago-docs/fa2446312177e9c6/loader.js","/docs/_mintlify/custom/lago-docs/c55d8403f7fc83ad/changelog-anchor-redirect.js","/docs/_mintlify/custom/lago-docs/8c326c8b67b47933/changelog-month-nav.js","/docs/_mintlify/custom/lago-docs/103c90943d27f62a/webmcp.js","/docs/_mintlify/custom/lago-docs/1219fb859e5c496e/github-outbound.js"],"openApiReferenceData":{"operation":{"tags":["customers"],"summary":"Retrieve customer attributed usage","description":"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.","operationId":"findCustomerAttributedUsage","parameters":["da7c990e-bf34-4c8b-b7ee-9a671142f8bb","39b91d91-7cb4-465f-8429-b43bfd163d35","3ec1a7b4-ae6a-4db4-85c9-ebfd0302c829","49d3e71a-76d3-4f0e-b39f-ee84441fd346","f96cfa73-821f-4e13-a48a-3854283e8cd0","ff4f1bf4-1477-4e27-9625-a2341a9fd4b3","e8a9a505-d1b0-4b75-800e-8d3152d11583","b2c32096-9b7c-4038-9808-ce4d4067132c","2fce27c6-b07a-4e4f-a80f-040287dcbb4d","3d16ddf7-5ffa-4ff4-9fe6-c0e728f3f1c3","e5cee6ba-eec0-4794-982f-e9335877de2f","eb1ed6e6-6256-4f1f-b13b-65133984c15b","e9922f39-9930-46f2-83cc-cbaa42986fe1"],"responses":{"200":"1aca2782-5f47-4daa-8cf2-25058c4e3c07","401":"e660d51d-d65c-4be8-b4d0-c0a48e21076f","403":"7bfdb4fb-eafa-432a-ad0f-63cd52379bf4","404":"15b17f0e-c1fc-4261-8a60-21ef407c2d5d","422":"6b71edbe-6785-47f6-81fa-05019e603d8a"},"method":"get","type":"path","servers":["6883bab9-ae25-4cbf-a420-acb0ddf98bb9","283cf0d7-f810-451c-b782-fbf6a1b3a96b"],"security":["a7c8a051-f5fe-48f1-a1c7-d4d9daf5d84b"],"path":"/customers/{external_customer_id}/attributed_usage","baseUrlOptions":["https://api.getlago.com/api/v1","https://api.eu.getlago.com/api/v1"],"title":"Retrieve customer attributed usage","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"da7c990e-bf34-4c8b-b7ee-9a671142f8bb":{"name":"external_customer_id","in":"path","description":"The customer external unique identifier (provided by your own application)","required":true,"schema":{"type":"string","example":"5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba","isRequired":true,"description":"The customer external unique identifier (provided by your own application)","uniqueKey":"","typeLabel":"string"}},"39b91d91-7cb4-465f-8429-b43bfd163d35":{"name":"external_subscription_id","in":"query","description":"The unique identifier of the subscription within your application. The subscription must be active.","required":true,"explode":true,"schema":{"type":"string","example":"sub_1234567890","isRequired":true,"description":"The unique identifier of the subscription within your application. The subscription must be active.","uniqueKey":"","typeLabel":"string"}},"3ec1a7b4-ae6a-4db4-85c9-ebfd0302c829":{"name":"group_by","in":"query","description":"Code of the usage attribution type to group the usage by. When the type has a parent, `filters` must include a value of the parent type, so the tree is read one level at a time. Lago tracks up to 100,000 values per type for each customer. Once the type reaches this limit, grouping by it returns a `too_many_values` validation error, unless `filters` includes a value of its parent type.","required":true,"explode":true,"schema":{"type":"string","example":"team","isRequired":true,"description":"Code of the usage attribution type to group the usage by. When the type has a parent, `filters` must include a value of the parent type, so the tree is read one level at a time. Lago tracks up to 100,000 values per type for each customer. Once the type reaches this limit, grouping by it returns a `too_many_values` validation error, unless `filters` includes a value of its parent type.","uniqueKey":"","typeLabel":"string"}},"49d3e71a-76d3-4f0e-b39f-ee84441fd346":{"name":"filters","in":"query","description":"Values of usage attribution types to filter the usage by, keyed by type code, e.g. `filters[department]=rnd\u0026filters[model][]=opus\u0026filters[model][]=haiku`. Each type accepts up to 20 values, and up to 3 `flat` types can be filtered on. More than 20 values for a type returns a `too_many_values` validation error.","required":false,"style":"deepObject","explode":true,"schema":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additionalProperties","typeLabel":"string | string[]"},"example":{"department":"rnd"},"isRequired":false,"description":"Values of usage attribution types to filter the usage by, keyed by type code, e.g. `filters[department]=rnd\u0026filters[model][]=opus\u0026filters[model][]=haiku`. Each type accepts up to 20 values, and up to 3 `flat` types can be filtered on. More than 20 values for a type returns a `too_many_values` validation error.","uniqueKey":"","typeLabel":"object"}},"f96cfa73-821f-4e13-a48a-3854283e8cd0":{"name":"from_datetime","in":"query","description":"Start of the period, in ISO 8601 format. It must be sent together with `to_datetime`, and the period cannot be longer than 31 days. It is moved to the start of the subscription when earlier.","required":false,"explode":true,"schema":{"type":"string","format":"date-time","example":"2022-04-01T00:00:00Z","isRequired":false,"description":"Start of the period, in ISO 8601 format. It must be sent together with `to_datetime`, and the period cannot be longer than 31 days. It is moved to the start of the subscription when earlier.","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"ff4f1bf4-1477-4e27-9625-a2341a9fd4b3":{"name":"to_datetime","in":"query","description":"End of the period, in ISO 8601 format. It must be sent together with `from_datetime`.","required":false,"explode":true,"schema":{"type":"string","format":"date-time","example":"2022-04-30T23:59:59Z","isRequired":false,"description":"End of the period, in ISO 8601 format. It must be sent together with `from_datetime`.","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"e8a9a505-d1b0-4b75-800e-8d3152d11583":{"name":"charge_codes[]","in":"query","description":"Codes of the charges of the plan to include. All the supported charges are included when it is not sent.","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"example":["tokens"],"isRequired":false,"description":"Codes of the charges of the plan to include. All the supported charges are included when it is not sent.","uniqueKey":"","typeLabel":"string[]"}},"b2c32096-9b7c-4038-9808-ce4d4067132c":{"name":"split_charge_code","in":"query","description":"Code of a charge of the plan to split by charge filter, with one entry per filter in `charges_usage`. The filters are returned 10 at a time, in the order of the charge, starting at `split_filters_offset`. The charge must have at least 1 filter, and must be part of `charge_codes[]` when it is sent. A `too_many_filters` validation error is returned when the filter values of the charge are too many to match events.","required":false,"explode":true,"schema":{"type":"string","example":"tokens","isRequired":false,"description":"Code of a charge of the plan to split by charge filter, with one entry per filter in `charges_usage`. The filters are returned 10 at a time, in the order of the charge, starting at `split_filters_offset`. The charge must have at least 1 filter, and must be part of `charge_codes[]` when it is sent. A `too_many_filters` validation error is returned when the filter values of the charge are too many to match events.","uniqueKey":"","typeLabel":"string"}},"2fce27c6-b07a-4e4f-a80f-040287dcbb4d":{"name":"split_filters_offset","in":"query","description":"Index of the first filter of the split charge to return, starting at 0. Use it with `split_filters_count` to page through the filters 10 at a time. It is ignored when `split_charge_code` is not sent.","required":false,"explode":true,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0,"example":10,"isRequired":false,"description":"Index of the first filter of the split charge to return, starting at 0. Use it with `split_filters_count` to page through the filters 10 at a time. It is ignored when `split_charge_code` is not sent.","uniqueKey":"","typeLabel":"integer"}},"3d16ddf7-5ffa-4ff4-9fe6-c0e728f3f1c3":{"name":"search_term","in":"query","description":"Filter the attribution values by search term, up to 100 characters. The totals are not affected by the search.","required":false,"explode":true,"schema":{"type":"string","maxLength":100,"example":"eng","isRequired":false,"description":"Filter the attribution values by search term, up to 100 characters. The totals are not affected by the search.","uniqueKey":"","typeLabel":"string"}},"e5cee6ba-eec0-4794-982f-e9335877de2f":{"name":"basis","in":"query","description":"Basis of the breakdown. With `units`, no amount is computed and values are ranked by units, summed across the selected charges. With `amount`, amounts are computed and values are ranked by amount.","required":false,"explode":true,"schema":{"type":"string","enum":["units","amount"],"default":"units","example":"amount","isRequired":false,"description":"Basis of the breakdown. With `units`, no amount is computed and values are ranked by units, summed across the selected charges. With `amount`, amounts are computed and values are ranked by amount.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"eb1ed6e6-6256-4f1f-b13b-65133984c15b":{"name":"page","in":"query","description":"Page number. Defaults to 1. A value that is not a positive integer, such as `0`, returns the first page.","required":false,"explode":true,"schema":{"type":"integer","example":1,"isRequired":false,"description":"Page number. Defaults to 1. A value that is not a positive integer, such as `0`, returns the first page.","uniqueKey":"","typeLabel":"integer"}},"e9922f39-9930-46f2-83cc-cbaa42986fe1":{"name":"per_page","in":"query","description":"Number of attribution values per page, between 1 and 100.","required":false,"explode":true,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"example":20,"isRequired":false,"description":"Number of attribution values per page, between 1 and 100.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"1aca2782-5f47-4daa-8cf2-25058c4e3c07":{"description":"Customer attributed usage","content":{"application/json":{"schema":{"type":"object","required":["attributed_usage","meta"],"properties":{"attributed_usage":{"type":"object","required":["lago_subscription_id","external_subscription_id","group_by","basis","from_datetime","to_datetime","currency","split_filters_count","rows","unattributed","totals"],"properties":{"lago_subscription_id":{"type":"string","format":"uuid","description":"Unique identifier of the subscription, created by Lago.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.lago_subscription_id","typeLabel":"string\u003cuuid>"},"external_subscription_id":{"type":"string","description":"Unique identifier of the subscription in your application.","example":"sub_1234567890","isRequired":true,"uniqueKey":"attributed_usage.external_subscription_id","typeLabel":"string"},"group_by":{"type":"string","description":"Code of the usage attribution type the usage is grouped by.","example":"team","isRequired":true,"uniqueKey":"attributed_usage.group_by","typeLabel":"string"},"basis":{"type":"string","enum":["units","amount"],"description":"Basis of the breakdown. With `units`, amounts are `null` and values are ranked by units, summed across the selected charges. With `amount`, amounts are computed and values are ranked by amount.","example":"amount","isRequired":true,"uniqueKey":"attributed_usage.basis","typeLabel":"enum\u003cstring>"},"from_datetime":{"type":"string","format":"date-time","description":"Start of the period of the usage, in UTC.","example":"2022-04-01T00:00:00Z","isRequired":true,"uniqueKey":"attributed_usage.from_datetime","typeLabel":"string\u003cdate-time>"},"to_datetime":{"type":"string","format":"date-time","description":"End of the period of the usage, in UTC.","example":"2022-04-30T23:59:59Z","isRequired":true,"uniqueKey":"attributed_usage.to_datetime","typeLabel":"string\u003cdate-time>"},"currency":{"type":"string","example":"USD","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BIF","BMD","BND","BOB","BRL","BSD","BWP","BYN","BZD","CAD","CDF","CHF","CLF","CLP","CNY","COP","CRC","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","ISK","JMD","JPY","KES","KGS","KHR","KMF","KRW","KYD","KZT","LAK","LBP","LKR","LRD","LSL","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRO","MUR","MVR","MWK","MXN","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SEK","SGD","SHP","SLL","SOS","SRD","STD","SYP","SZL","THB","TJS","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","UYU","UZS","VND","VUV","WST","XAF","XCD","XOF","XPF","YER","ZAR","ZMW"],"isRequired":true,"uniqueKey":"attributed_usage.currency","typeLabel":"enum\u003cstring>"},"split_filters_count":{"oneOf":[{"type":"integer","description":"Number of filters of the charge split by `split_charge_code`, across all pages. Each response returns up to 10 of them, starting at `split_filters_offset`. It is `null` when no charge is split.","example":42,"isRequired":true,"uniqueKey":"attributed_usage.split_filters_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Number of filters of the charge split by `split_charge_code`, across all pages. Each response returns up to 10 of them, starting at `split_filters_offset`. It is `null` when no charge is split.","example":42,"isRequired":true,"uniqueKey":"attributed_usage.split_filters_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.split_filters_count","typeLabel":"integer | null"},"rows":{"type":"array","items":{"type":"object","required":["value","rank","amount_cents","precise_amount_cents","events_count","split_charge_units","charges_usage"],"properties":{"value":{"type":"string","description":"Attribution value the usage is attributed to, at the level of the `group_by` usage attribution type.","example":"engineering","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].value","typeLabel":"string"},"rank":{"type":"integer","description":"Rank of the value in the level, starting at 1. Values are ranked by amount when `basis` is `amount`, and by units, summed across the selected charges, when `basis` is `units`. Values with the same amount or units are ranked by value, in ascending order.","example":1,"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].rank","typeLabel":"integer"},"amount_cents":{"oneOf":[{"type":"integer","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`.","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].amount_cents.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`.","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].amount_cents","typeLabel":"integer | null"},"precise_amount_cents":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` when `basis` is `units`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].precise_amount_cents.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` when `basis` is `units`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].precise_amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].precise_amount_cents","typeLabel":"string | null"},"events_count":{"type":"integer","description":"Number of events.","example":42,"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].events_count","typeLabel":"integer"},"split_charge_units":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Units of the charge split by `split_charge_code`, across all its filters and the usage that matches none of them, sent as a decimal string. Unlike `charges_usage`, it covers the filters of every page. It is `null` when no charge is split.","example":"15000.5","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].split_charge_units.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Units of the charge split by `split_charge_code`, across all its filters and the usage that matches none of them, sent as a decimal string. Unlike `charges_usage`, it covers the filters of every page. It is `null` when no charge is split.","example":"15000.5","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].split_charge_units.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].split_charge_units","typeLabel":"string | null"},"charges_usage":{"type":"array","items":{"type":"object","required":["lago_charge_id","charge_code","billable_metric_code","lago_charge_filter_id","charge_filter_values","charge_filter_invoice_display_name","units","amount_cents","precise_amount_cents","events_count"],"properties":{"lago_charge_id":{"type":"string","format":"uuid","description":"Unique identifier of the charge, created by Lago.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].lago_charge_id","typeLabel":"string\u003cuuid>"},"charge_code":{"type":"string","description":"Code of the charge.","example":"tokens","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_code","typeLabel":"string"},"billable_metric_code":{"type":"string","description":"Code of the billable metric of the charge.","example":"tokens","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].billable_metric_code","typeLabel":"string"},"lago_charge_filter_id":{"oneOf":[{"type":"string","format":"uuid","description":"Unique identifier of the charge filter, created by Lago. It is set only for the charge split by `split_charge_code`, and is `null` for the usage that matches none of its filters.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].lago_charge_filter_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Unique identifier of the charge filter, created by Lago. It is set only for the charge split by `split_charge_code`, and is `null` for the usage that matches none of its filters.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].lago_charge_filter_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].lago_charge_filter_id","typeLabel":"string\u003cuuid> | null"},"charge_filter_values":{"oneOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_values.oneOf.0.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_values.oneOf.0.additionalProperties","typeLabel":"string[]"},"description":"Values of the charge filter, by billable metric filter key. It is `null` when `lago_charge_filter_id` is `null`.","example":{"model":["opus"]},"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_values.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_values.oneOf.1.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_values.oneOf.1.additionalProperties","typeLabel":"string[]"},"description":"Values of the charge filter, by billable metric filter key. It is `null` when `lago_charge_filter_id` is `null`.","example":{"model":["opus"]},"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_values.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_values","typeLabel":"object | null"},"charge_filter_invoice_display_name":{"oneOf":[{"type":"string","description":"Name of the charge filter displayed on the invoice. It is `null` when `lago_charge_filter_id` is `null` or when the filter has no display name.","example":"Opus tokens","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_invoice_display_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the charge filter displayed on the invoice. It is `null` when `lago_charge_filter_id` is `null` or when the filter has no display name.","example":"Opus tokens","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_invoice_display_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].charge_filter_invoice_display_name","typeLabel":"string | null"},"units":{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Number of units consumed, sent as a decimal string.","example":"1250.5","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].units","typeLabel":"string"},"amount_cents":{"oneOf":[{"type":"integer","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`, or when the charge cannot be priced (only charges with the `standard` charge model are priced).","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].amount_cents.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`, or when the charge cannot be priced (only charges with the `standard` charge model are priced).","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].amount_cents","typeLabel":"integer | null"},"precise_amount_cents":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` in the same cases as `amount_cents`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].precise_amount_cents.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` in the same cases as `amount_cents`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].precise_amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].precise_amount_cents","typeLabel":"string | null"},"events_count":{"type":"integer","description":"Number of events.","example":42,"isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX].events_count","typeLabel":"integer"}},"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage.items.[INDEX]","typeLabel":"object"},"description":"Usage of each charge of the plan, in the order of the charges. A charge split by `split_charge_code` has one entry per filter of the page selected by `split_filters_offset`, then one for the usage that matches none of its filters. The filters of other pages have no entry, but their usage still counts in the amount.","isRequired":true,"uniqueKey":"attributed_usage.rows.items.[INDEX].charges_usage","typeLabel":"object[]"}},"uniqueKey":"attributed_usage.rows.items.[INDEX]","typeLabel":"object"},"description":"Usage of each attribution value of the page, ordered by rank.","isRequired":true,"uniqueKey":"attributed_usage.rows","typeLabel":"object[]"},"unattributed":{"type":"object","description":"Usage of the events that carry no value for the `group_by` usage attribution type.","required":["amount_cents","precise_amount_cents","events_count","split_charge_units","charges_usage"],"properties":{"amount_cents":{"oneOf":[{"type":"integer","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`.","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.unattributed.amount_cents.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`.","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.unattributed.amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.unattributed.amount_cents","typeLabel":"integer | null"},"precise_amount_cents":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` when `basis` is `units`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.unattributed.precise_amount_cents.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` when `basis` is `units`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.unattributed.precise_amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.unattributed.precise_amount_cents","typeLabel":"string | null"},"events_count":{"type":"integer","description":"Number of events.","example":42,"isRequired":true,"uniqueKey":"attributed_usage.unattributed.events_count","typeLabel":"integer"},"split_charge_units":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Units of the charge split by `split_charge_code`, across all its filters and the usage that matches none of them, sent as a decimal string. Unlike `charges_usage`, it covers the filters of every page. It is `null` when no charge is split.","example":"15000.5","isRequired":true,"uniqueKey":"attributed_usage.unattributed.split_charge_units.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Units of the charge split by `split_charge_code`, across all its filters and the usage that matches none of them, sent as a decimal string. Unlike `charges_usage`, it covers the filters of every page. It is `null` when no charge is split.","example":"15000.5","isRequired":true,"uniqueKey":"attributed_usage.unattributed.split_charge_units.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.unattributed.split_charge_units","typeLabel":"string | null"},"charges_usage":{"type":"array","items":{"type":"object","required":["lago_charge_id","charge_code","billable_metric_code","lago_charge_filter_id","charge_filter_values","charge_filter_invoice_display_name","units","amount_cents","precise_amount_cents","events_count"],"properties":{"lago_charge_id":{"type":"string","format":"uuid","description":"Unique identifier of the charge, created by Lago.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].lago_charge_id","typeLabel":"string\u003cuuid>"},"charge_code":{"type":"string","description":"Code of the charge.","example":"tokens","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_code","typeLabel":"string"},"billable_metric_code":{"type":"string","description":"Code of the billable metric of the charge.","example":"tokens","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].billable_metric_code","typeLabel":"string"},"lago_charge_filter_id":{"oneOf":[{"type":"string","format":"uuid","description":"Unique identifier of the charge filter, created by Lago. It is set only for the charge split by `split_charge_code`, and is `null` for the usage that matches none of its filters.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].lago_charge_filter_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Unique identifier of the charge filter, created by Lago. It is set only for the charge split by `split_charge_code`, and is `null` for the usage that matches none of its filters.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].lago_charge_filter_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].lago_charge_filter_id","typeLabel":"string\u003cuuid> | null"},"charge_filter_values":{"oneOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_values.oneOf.0.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_values.oneOf.0.additionalProperties","typeLabel":"string[]"},"description":"Values of the charge filter, by billable metric filter key. It is `null` when `lago_charge_filter_id` is `null`.","example":{"model":["opus"]},"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_values.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_values.oneOf.1.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_values.oneOf.1.additionalProperties","typeLabel":"string[]"},"description":"Values of the charge filter, by billable metric filter key. It is `null` when `lago_charge_filter_id` is `null`.","example":{"model":["opus"]},"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_values.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_values","typeLabel":"object | null"},"charge_filter_invoice_display_name":{"oneOf":[{"type":"string","description":"Name of the charge filter displayed on the invoice. It is `null` when `lago_charge_filter_id` is `null` or when the filter has no display name.","example":"Opus tokens","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_invoice_display_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the charge filter displayed on the invoice. It is `null` when `lago_charge_filter_id` is `null` or when the filter has no display name.","example":"Opus tokens","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_invoice_display_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].charge_filter_invoice_display_name","typeLabel":"string | null"},"units":{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Number of units consumed, sent as a decimal string.","example":"1250.5","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].units","typeLabel":"string"},"amount_cents":{"oneOf":[{"type":"integer","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`, or when the charge cannot be priced (only charges with the `standard` charge model are priced).","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].amount_cents.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`, or when the charge cannot be priced (only charges with the `standard` charge model are priced).","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].amount_cents","typeLabel":"integer | null"},"precise_amount_cents":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` in the same cases as `amount_cents`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].precise_amount_cents.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` in the same cases as `amount_cents`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].precise_amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].precise_amount_cents","typeLabel":"string | null"},"events_count":{"type":"integer","description":"Number of events.","example":42,"isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX].events_count","typeLabel":"integer"}},"uniqueKey":"attributed_usage.unattributed.charges_usage.items.[INDEX]","typeLabel":"object"},"description":"Usage of each charge of the plan, in the order of the charges. A charge split by `split_charge_code` has one entry per filter of the page selected by `split_filters_offset`, then one for the usage that matches none of its filters. The filters of other pages have no entry, but their usage still counts in the amount.","isRequired":true,"uniqueKey":"attributed_usage.unattributed.charges_usage","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"attributed_usage.unattributed","typeLabel":"object"},"totals":{"type":"object","description":"Usage of the whole level, attributed and unattributed, for all pages. A `search_term` does not narrow the totals.","required":["amount_cents","precise_amount_cents","events_count","split_charge_units","charges_usage"],"properties":{"amount_cents":{"oneOf":[{"type":"integer","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`.","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.totals.amount_cents.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`.","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.totals.amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.totals.amount_cents","typeLabel":"integer | null"},"precise_amount_cents":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` when `basis` is `units`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.totals.precise_amount_cents.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` when `basis` is `units`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.totals.precise_amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.totals.precise_amount_cents","typeLabel":"string | null"},"events_count":{"type":"integer","description":"Number of events.","example":42,"isRequired":true,"uniqueKey":"attributed_usage.totals.events_count","typeLabel":"integer"},"split_charge_units":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Units of the charge split by `split_charge_code`, across all its filters and the usage that matches none of them, sent as a decimal string. Unlike `charges_usage`, it covers the filters of every page. It is `null` when no charge is split.","example":"15000.5","isRequired":true,"uniqueKey":"attributed_usage.totals.split_charge_units.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Units of the charge split by `split_charge_code`, across all its filters and the usage that matches none of them, sent as a decimal string. Unlike `charges_usage`, it covers the filters of every page. It is `null` when no charge is split.","example":"15000.5","isRequired":true,"uniqueKey":"attributed_usage.totals.split_charge_units.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.totals.split_charge_units","typeLabel":"string | null"},"charges_usage":{"type":"array","items":{"type":"object","required":["lago_charge_id","charge_code","billable_metric_code","lago_charge_filter_id","charge_filter_values","charge_filter_invoice_display_name","units","amount_cents","precise_amount_cents","events_count"],"properties":{"lago_charge_id":{"type":"string","format":"uuid","description":"Unique identifier of the charge, created by Lago.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].lago_charge_id","typeLabel":"string\u003cuuid>"},"charge_code":{"type":"string","description":"Code of the charge.","example":"tokens","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_code","typeLabel":"string"},"billable_metric_code":{"type":"string","description":"Code of the billable metric of the charge.","example":"tokens","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].billable_metric_code","typeLabel":"string"},"lago_charge_filter_id":{"oneOf":[{"type":"string","format":"uuid","description":"Unique identifier of the charge filter, created by Lago. It is set only for the charge split by `split_charge_code`, and is `null` for the usage that matches none of its filters.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].lago_charge_filter_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Unique identifier of the charge filter, created by Lago. It is set only for the charge split by `split_charge_code`, and is `null` for the usage that matches none of its filters.","example":"1a901a90-1a90-1a90-1a90-1a901a901a90","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].lago_charge_filter_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].lago_charge_filter_id","typeLabel":"string\u003cuuid> | null"},"charge_filter_values":{"oneOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_values.oneOf.0.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_values.oneOf.0.additionalProperties","typeLabel":"string[]"},"description":"Values of the charge filter, by billable metric filter key. It is `null` when `lago_charge_filter_id` is `null`.","example":{"model":["opus"]},"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_values.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_values.oneOf.1.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_values.oneOf.1.additionalProperties","typeLabel":"string[]"},"description":"Values of the charge filter, by billable metric filter key. It is `null` when `lago_charge_filter_id` is `null`.","example":{"model":["opus"]},"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_values.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_values","typeLabel":"object | null"},"charge_filter_invoice_display_name":{"oneOf":[{"type":"string","description":"Name of the charge filter displayed on the invoice. It is `null` when `lago_charge_filter_id` is `null` or when the filter has no display name.","example":"Opus tokens","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_invoice_display_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the charge filter displayed on the invoice. It is `null` when `lago_charge_filter_id` is `null` or when the filter has no display name.","example":"Opus tokens","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_invoice_display_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].charge_filter_invoice_display_name","typeLabel":"string | null"},"units":{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Number of units consumed, sent as a decimal string.","example":"1250.5","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].units","typeLabel":"string"},"amount_cents":{"oneOf":[{"type":"integer","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`, or when the charge cannot be priced (only charges with the `standard` charge model are priced).","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].amount_cents.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Amount of the usage in cents, rounded to the nearest cent. It is `null` when `basis` is `units`, or when the charge cannot be priced (only charges with the `standard` charge model are priced).","example":1200,"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].amount_cents","typeLabel":"integer | null"},"precise_amount_cents":{"oneOf":[{"type":"string","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` in the same cases as `amount_cents`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].precise_amount_cents.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^-?[0-9]+(\\.[0-9]+)?$","description":"Amount of the usage in cents, sent as a decimal string. It is `null` in the same cases as `amount_cents`.","example":"1200.4567","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].precise_amount_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].precise_amount_cents","typeLabel":"string | null"},"events_count":{"type":"integer","description":"Number of events.","example":42,"isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX].events_count","typeLabel":"integer"}},"uniqueKey":"attributed_usage.totals.charges_usage.items.[INDEX]","typeLabel":"object"},"description":"Usage of each charge of the plan, in the order of the charges. A charge split by `split_charge_code` has one entry per filter of the page selected by `split_filters_offset`, then one for the usage that matches none of its filters. The filters of other pages have no entry, but their usage still counts in the amount.","isRequired":true,"uniqueKey":"attributed_usage.totals.charges_usage","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"attributed_usage.totals","typeLabel":"object"}},"isRequired":true,"uniqueKey":"attributed_usage","typeLabel":"object"},"meta":{"type":"object","required":["current_page","total_pages","total_count"],"properties":{"current_page":{"type":"integer","description":"Current page.","example":2,"isRequired":true,"uniqueKey":"meta.current_page","typeLabel":"integer"},"total_pages":{"type":"integer","description":"Total number of pages.","example":4,"isRequired":true,"uniqueKey":"meta.total_pages","typeLabel":"integer"},"total_count":{"type":"integer","description":"Total number of records.","example":70,"isRequired":true,"uniqueKey":"meta.total_count","typeLabel":"integer"},"next_page":{"oneOf":[{"type":"integer","description":"Next page.","example":3,"uniqueKey":"meta.next_page.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Next page.","example":3,"uniqueKey":"meta.next_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.next_page","typeLabel":"integer | null"},"prev_page":{"oneOf":[{"type":"integer","description":"Previous page.","example":1,"uniqueKey":"meta.prev_page.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Previous page.","example":1,"uniqueKey":"meta.prev_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.prev_page","typeLabel":"integer | null"}},"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"attributed_usage":{"lago_subscription_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","external_subscription_id":"sub_1234567890","group_by":"team","basis":"amount","from_datetime":"2022-04-01T00:00:00Z","to_datetime":"2022-04-30T23:59:59Z","currency":"USD","split_filters_count":42,"rows":[{"value":"engineering","rank":1,"amount_cents":1200,"precise_amount_cents":"1200.4567","events_count":42,"split_charge_units":"15000.5","charges_usage":[{"lago_charge_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","charge_code":"tokens","billable_metric_code":"tokens","lago_charge_filter_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","charge_filter_values":{"model":["opus"]},"charge_filter_invoice_display_name":"Opus tokens","units":"1250.5","amount_cents":1200,"precise_amount_cents":"1200.4567","events_count":42}]}],"unattributed":{"amount_cents":1200,"precise_amount_cents":"1200.4567","events_count":42,"split_charge_units":"15000.5","charges_usage":[{"lago_charge_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","charge_code":"tokens","billable_metric_code":"tokens","lago_charge_filter_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","charge_filter_values":{"model":["opus"]},"charge_filter_invoice_display_name":"Opus tokens","units":"1250.5","amount_cents":1200,"precise_amount_cents":"1200.4567","events_count":42}]},"totals":{"amount_cents":1200,"precise_amount_cents":"1200.4567","events_count":42,"split_charge_units":"15000.5","charges_usage":[{"lago_charge_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","charge_code":"tokens","billable_metric_code":"tokens","lago_charge_filter_id":"1a901a90-1a90-1a90-1a90-1a901a901a90","charge_filter_values":{"model":["opus"]},"charge_filter_invoice_display_name":"Opus tokens","units":"1250.5","amount_cents":1200,"precise_amount_cents":"1200.4567","events_count":42}]}},"meta":{"current_page":2,"total_pages":4,"total_count":70,"next_page":3,"prev_page":1}}}},"exampleType":"generated"}},"exampleType":"generated"},"e660d51d-d65c-4be8-b4d0-c0a48e21076f":{"description":"Unauthorized error","content":{"application/json":{"schema":{"type":"object","required":["status","error"],"properties":{"status":{"type":"integer","format":"int32","example":401,"isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":401,"error":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"7bfdb4fb-eafa-432a-ad0f-63cd52379bf4":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","required":["status","error","code"],"properties":{"status":{"type":"integer","format":"int32","example":403,"isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"error":{"type":"string","example":"Forbidden","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","example":"feature_unavailable","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":403,"error":"Forbidden","code":"feature_unavailable"}}},"exampleType":"generated"}},"exampleType":"generated"},"15b17f0e-c1fc-4261-8a60-21ef407c2d5d":{"description":"Not Found error","content":{"application/json":{"schema":{"type":"object","required":["status","error","code"],"properties":{"status":{"type":"integer","format":"int32","example":404,"isRequired":true,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"error":{"type":"string","example":"Not Found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","example":"object_not_found","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":404,"error":"Not Found","code":"object_not_found"}}},"exampleType":"generated"}},"exampleType":"generated"},"6b71edbe-6785-47f6-81fa-05019e603d8a":{"description":"Unprocessable entity error","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["status","error","code","error_details"],"properties":{"status":{"type":"integer","format":"int32","example":422,"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"integer\u003cint32>"},"error":{"type":"string","example":"Unprocessable entity","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"},"code":{"type":"string","example":"validation_errors","isRequired":true,"uniqueKey":"oneOf.0.code","typeLabel":"string"},"error_details":{"type":"object","isRequired":true,"uniqueKey":"oneOf.0.error_details","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["status","error","code"],"properties":{"status":{"type":"integer","format":"int32","example":422,"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"integer\u003cint32>"},"error":{"type":"string","example":"Unprocessable Entity","isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"string"},"code":{"type":"string","enum":["too_many_groups","query_timeout","memory_limit_exceeded"],"description":"Reason why the query exceeded its limits. Narrow the period or add filters, then retry.","example":"too_many_groups","isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":422,"error":"Unprocessable entity","code":"validation_errors","error_details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a7c8a051-f5fe-48f1-a1c7-d4d9daf5d84b":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"6883bab9-ae25-4cbf-a420-acb0ddf98bb9":{"url":"https://api.getlago.com/api/v1","description":"US Lago cluster"},"283cf0d7-f810-451c-b782-fbf6a1b3a96b":{"url":"https://api.eu.getlago.com/api/v1","description":"EU Lago cluster"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","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":"https://swagger.getlago.com/openapi.yaml"},"subdomain":"lago-docs","siteName":"Lago","title":"Retrieve attributed usage - Lago","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T15:18:04.489Z","originalFileLocation":"api-reference/governance/get-attributed-usage.mdx"},"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=\"system\"}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=\"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Lago API, billing API, usage metering API, OpenAPI, billing SDK, Lago MCP\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lago\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_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=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve attributed usage - Lago\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lago\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://getlago.com/docs/api-reference/governance/get-attributed-usage\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lago-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Governance\u0026amp;title=Retrieve+attributed+usage\u0026amp;description=This+endpoint+retrieves+the+usage+of+an+active+subscription+per+value+of+a+governance+entity%2C+with+optional+filters%2C+a+custom+time+range+and+one+charge+split+by\u0026amp;theme=e69bad9b2f17285816711238\u0026amp;signature=36fd0a47cb1a9fc643e521c22d09e73a59390a059c59bac9e03061620613f322\">\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=\"Retrieve attributed usage - Lago\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lago-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Governance\u0026amp;title=Retrieve+attributed+usage\u0026amp;description=This+endpoint+retrieves+the+usage+of+an+active+subscription+per+value+of+a+governance+entity%2C+with+optional+filters%2C+a+custom+time+range+and+one+charge+split+by\u0026amp;theme=e69bad9b2f17285816711238\u0026amp;signature=36fd0a47cb1a9fc643e521c22d09e73a59390a059c59bac9e03061620613f322\">\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=\"/docs/mintlify-assets/_mintlify/favicons/lago-docs/PXUAhcpsneOuo3Dn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lago\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#006CFA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://getlago.com/docs/api-reference/governance/get-attributed-usage\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/governance/get-attributed-usage.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://getlago.com/#organization\",\"name\":\"Lago\",\"legalName\":\"Get Lago Corp.\",\"url\":\"https://getlago.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://getlago.com/docs/logo/light.svg\"},\"sameAs\":[\"https://github.com/getlago\",\"https://www.linkedin.com/company/getlago\",\"https://x.com/GetLago\",\"https://www.youtube.com/channel/UCp6ltp7n3SgDVsmerJ7O7ZA\"]},{\"@type\":\"WebSite\",\"@id\":\"https://getlago.com/docs#website\",\"name\":\"Lago\",\"url\":\"https://getlago.com/docs\",\"publisher\":{\"@id\":\"https://getlago.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://getlago.com/docs/api-reference/governance/get-attributed-usage#webpage\",\"url\":\"https://getlago.com/docs/api-reference/governance/get-attributed-usage\",\"name\":\"Retrieve attributed usage\",\"description\":\"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.\",\"dateModified\":\"2026-11-10T15:18:04.489Z\",\"isPartOf\":{\"@id\":\"https://getlago.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://getlago.com/docs/api-reference/governance/get-attributed-usage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://getlago.com/docs/api-reference/governance/get-attributed-usage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://getlago.com/docs/api-reference/intro\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Governance\",\"item\":\"https://getlago.com/docs/api-reference/governance/entity-object\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve attributed usage\",\"item\":\"https://getlago.com/docs/api-reference/governance/get-attributed-usage\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://getlago.com/docs/api-reference/governance/get-attributed-usage#apireference\",\"headline\":\"Retrieve attributed usage\",\"name\":\"Retrieve attributed usage\",\"description\":\"This endpoint retrieves the usage of an active subscription per value of a governance entity, with optional filters, a custom time range and one charge split by its filters.\",\"url\":\"https://getlago.com/docs/api-reference/governance/get-attributed-usage\",\"mainEntityOfPage\":{\"@id\":\"https://getlago.com/docs/api-reference/governance/get-attributed-usage#webpage\"},\"dateModified\":\"2026-11-10T15:18:04.489Z\",\"publisher\":{\"@id\":\"https://getlago.com/#organization\"},\"isPartOf\":{\"@id\":\"https://getlago.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Lago\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Lago","nav":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://getlago.com/blog"},{"anchor":"Community","icon":"slack","href":"https://getlago.com/slack"},{"anchor":"GitHub","icon":"github","href":"https://github.com/getlago/lago"},{"anchor":"Status","icon":"signal-bars","href":"https://status.getlago.com/"}]},"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/welcome"}]},{"tab":"Guide","pages":[{"title":"Guide","href":"/guide/introduction/welcome-to-lago"}]},{"tab":"API References","groups":[{"group":"API Reference","pages":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/api-reference/intro"},{"title":"API standards","href":"/api-reference/api-standards"},{"title":"API versioning and deprecation policy","href":"/api-reference/versioning"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Rate limits","href":"/api-reference/rate-limits"}]},{"group":"Add-ons","pages":[{"title":"The add-on object","href":"/api-reference/add-ons/add-on-object"},{"openapi":"POST /add_ons","title":"Create an add-on","href":"/api-reference/add-ons/create"},{"openapi":"PUT /add_ons/{code}","title":"Update an add-on","href":"/api-reference/add-ons/update"},{"openapi":"DELETE /add_ons/{code}","title":"Delete an add-on","href":"/api-reference/add-ons/destroy"},{"openapi":"GET /add_ons/{code}","title":"Retrieve an add-on","href":"/api-reference/add-ons/get-specific"},{"openapi":"GET /add_ons","title":"List all add-ons","href":"/api-reference/add-ons/get-all"}]},{"group":"Alerts","pages":[{"title":"The alert object","href":"/api-reference/alerts/alert-object"},{"openapi":"POST /subscriptions/{external_id}/alerts","title":"Create an alert","href":"/api-reference/alerts/create"},{"openapi":"PUT /subscriptions/{external_id}/alerts/{code}","title":"Update an alert","href":"/api-reference/alerts/update"},{"openapi":"DELETE /subscriptions/{external_id}/alerts/{code}","title":"Delete an alert","href":"/api-reference/alerts/delete"},{"openapi":"GET /subscriptions/{external_id}/alerts/{code}","title":"Retrieve an alert","href":"/api-reference/alerts/get-specific"},{"openapi":"GET /subscriptions/{external_id}/alerts","title":"List all alerts","href":"/api-reference/alerts/get-all"}]},{"group":"Audit logs","pages":[{"title":"The activity log object","href":"/api-reference/audit-logs/activity-logs-object"},{"openapi":"GET /activity_logs","title":"List all activity logs","href":"/api-reference/audit-logs/get-all-activity-logs"},{"openapi":"GET /activity_logs/{activity_id}","title":"Retrieve an activity log","href":"/api-reference/audit-logs/get-specific-activity-log"},{"title":"The API log object","href":"/api-reference/audit-logs/api-logs-object"},{"openapi":"GET /api_logs","title":"List all API logs","href":"/api-reference/audit-logs/get-all-api-logs"},{"openapi":"GET /api_logs/{request_id}","title":"Retrieve an API log","href":"/api-reference/audit-logs/get-specific-api-log"}]},{"group":"Billable metrics","pages":[{"title":"The billable metric object","href":"/api-reference/billable-metrics/object"},{"title":"Create a billable metric","openapi":"POST /billable_metrics","href":"/api-reference/billable-metrics/create"},{"title":"Update a billable metric","openapi":"PUT /billable_metrics/{code}","href":"/api-reference/billable-metrics/update"},{"openapi":"DELETE /billable_metrics/{code}","title":"Delete a billable metric","href":"/api-reference/billable-metrics/destroy"},{"openapi":"GET /billable_metrics/{code}","title":"Retrieve a billable metric","href":"/api-reference/billable-metrics/get-specific"},{"openapi":"GET /billable_metrics","title":"List all billable metrics","href":"/api-reference/billable-metrics/get-all"}]},{"group":"Billing entities","pages":[{"title":"The billing entity object","href":"/api-reference/billing-entities/object"},{"title":"Create a billing entity","openapi":"POST /billing_entities","href":"/api-reference/billing-entities/create"},{"title":"Update a billing entity","openapi":"PUT /billing_entities/{code}","href":"/api-reference/billing-entities/update"},{"title":"Retrieve a billing entity","openapi":"GET /billing_entities/{code}","href":"/api-reference/billing-entities/get-specific"},{"title":"List all billing entities","openapi":"GET /billing_entities","href":"/api-reference/billing-entities/get-all"}]},{"group":"Coupons","pages":[{"title":"The coupon object","href":"/api-reference/coupons/coupon-object"},{"openapi":"POST /coupons","title":"Create a coupon","href":"/api-reference/coupons/create"},{"openapi":"PUT /coupons/{code}","title":"Update a coupon","href":"/api-reference/coupons/update"},{"openapi":"DELETE /coupons/{code}","title":"Delete a coupon","href":"/api-reference/coupons/destroy"},{"openapi":"GET /coupons/{code}","title":"Retrieve a coupon","href":"/api-reference/coupons/get-specific"},{"openapi":"GET /coupons","title":"List all coupons","href":"/api-reference/coupons/get-all"},{"title":"The applied coupon object","href":"/api-reference/coupons/applied-coupon-object"},{"openapi":"POST /applied_coupons","title":"Apply a coupon","href":"/api-reference/coupons/apply"},{"openapi":"DELETE /customers/{external_customer_id}/applied_coupons/{applied_coupon_id}","title":"Delete an applied coupon","href":"/api-reference/coupons/destroy-applied-coupon"},{"openapi":"GET /applied_coupons","title":"List all applied coupons","href":"/api-reference/coupons/get-all-applied"}]},{"group":"Credit notes","pages":[{"title":"The credit note object","href":"/api-reference/credit-notes/credit-note-object"},{"openapi":"POST /credit_notes/estimate","title":"Estimate a credit note","href":"/api-reference/credit-notes/estimate"},{"openapi":"POST /credit_notes","title":"Create a credit note","href":"/api-reference/credit-notes/create"},{"openapi":"POST /credit_notes/{lago_id}/download","title":"Download a credit note","href":"/api-reference/credit-notes/download"},{"openapi":"PUT /credit_notes/{lago_id}","title":"Update a credit note","href":"/api-reference/credit-notes/update"},{"openapi":"PUT /credit_notes/{lago_id}/void","title":"Void available credit","href":"/api-reference/credit-notes/void"},{"openapi":"GET /credit_notes/{lago_id}","title":"Retrieve a credit note","href":"/api-reference/credit-notes/get-specific"},{"openapi":"GET /credit_notes","title":"List all credit notes","href":"/api-reference/credit-notes/get-all"},{"group":"Metadata","pages":[{"openapi":"POST /credit_notes/{lago_id}/metadata","title":"Replace all metadata","href":"/api-reference/credit-notes/metadata/create-metadata-cn"},{"openapi":"PATCH /credit_notes/{lago_id}/metadata","title":"Update metadata","href":"/api-reference/credit-notes/metadata/update-metadata-cn"},{"openapi":"DELETE /credit_notes/{lago_id}/metadata/{key}","title":"Delete a metadata","href":"/api-reference/credit-notes/metadata/delete-a-metadata-cn"},{"openapi":"DELETE /credit_notes/{lago_id}/metadata","title":"Delete all metadata","href":"/api-reference/credit-notes/metadata/delete-all-metadata-cn"}]}]},{"group":"Customer usage","pages":[{"title":"The customer usage object","href":"/api-reference/customer-usage/customer-usage-object"},{"openapi":"GET /analytics/usage","title":"Retrieve usages","href":"/api-reference/customer-usage/usages"},{"openapi":"GET /customers/{external_customer_id}/current_usage","title":"Retrieve current usage","href":"/api-reference/customer-usage/get-current"},{"openapi":"GET /customers/{external_customer_id}/projected_usage","title":"Retrieve projected usage","href":"/api-reference/customer-usage/get-projected"},{"openapi":"GET /customers/{external_customer_id}/past_usage","title":"Retrieve past usage","href":"/api-reference/customer-usage/get-past"}]},{"group":"Customers","pages":[{"title":"The customer object","href":"/api-reference/customers/object"},{"openapi":"POST /customers","title":"Create a customer","href":"/api-reference/customers/create"},{"openapi":"POST /customers","title":"Update a customer","href":"/api-reference/customers/update"},{"openapi":"POST /customers/{external_customer_id}/checkout_url","title":"Regenerate checkout URL","href":"/api-reference/customers/psp-checkout-url"},{"openapi":"DELETE /customers/{external_customer_id}","title":"Delete a customer","href":"/api-reference/customers/delete"},{"openapi":"GET /customers/{external_customer_id}","title":"Retrieve a customer","href":"/api-reference/customers/get-specific"},{"openapi":"GET /customers","title":"List all customers","href":"/api-reference/customers/get-all"},{"openapi":"GET /customers/{external_customer_id}/portal_url","title":"Retrieve customer portal URL","href":"/api-reference/customers/customer-portal"}]},{"group":"Entitlements","pages":[{"title":"The feature object","href":"/api-reference/entitlements/features/feature-object"},{"openapi":"POST /features","title":"Create a feature","href":"/api-reference/entitlements/features/create-feature"},{"openapi":"PUT /features/{code}","title":"Update a feature","href":"/api-reference/entitlements/features/update-feature"},{"openapi":"DELETE /features/{code}","title":"Delete a feature","href":"/api-reference/entitlements/features/delete-feature"},{"openapi":"DELETE /features/{code}/privileges/{privilege_code}","title":"Delete a feature privilege","href":"/api-reference/entitlements/features/delete-privilege"},{"openapi":"GET /features/{code}","title":"Retrieve a feature","href":"/api-reference/entitlements/features/get-feature"},{"openapi":"GET /features","title":"List all features","href":"/api-reference/entitlements/features/get-all-features"},{"title":"The plan entitlement object","href":"/api-reference/entitlements/plan-entitlements/plan-entitlement-object"},{"openapi":"POST /plans/{code}/entitlements","title":"Create plan entitlements","href":"/api-reference/entitlements/plan-entitlements/create-plan-entitlement"},{"openapi":"PATCH /plans/{code}/entitlements","title":"Update plan entitlements","href":"/api-reference/entitlements/plan-entitlements/update-plan-entitlement"},{"openapi":"DELETE /plans/{code}/entitlements/{feature_code}","title":"Delete a plan entitlement","href":"/api-reference/entitlements/plan-entitlements/delete-plan-entitlement"},{"openapi":"DELETE /plans/{code}/entitlements/{feature_code}/privileges/{privilege_code}","title":"Delete a plan entitlement privilege","href":"/api-reference/entitlements/plan-entitlements/delete-plan-entitlement-privilege"},{"openapi":"GET /plans/{code}/entitlements/{feature_code}","title":"Retrieve a plan entitlement","href":"/api-reference/entitlements/plan-entitlements/get-specific-plan-entitlement"},{"openapi":"GET /plans/{code}/entitlements","title":"List plan entitlements","href":"/api-reference/entitlements/plan-entitlements/get-all-plan-entitlements"},{"title":"The subscription entitlement object","href":"/api-reference/entitlements/subscription-entitlements/subscription-entitlement-object"},{"openapi":"PATCH /subscriptions/{external_id}/entitlements","title":"Update subscription entitlements","href":"/api-reference/entitlements/subscription-entitlements/update-subscription-entitlement"},{"openapi":"DELETE /subscriptions/{external_id}/entitlements/{feature_code}","title":"Delete a subscription entitlement","href":"/api-reference/entitlements/subscription-entitlements/delete-subscription-entitlement"},{"openapi":"DELETE /subscriptions/{external_id}/entitlements/{feature_code}/privileges/{privilege_code}","title":"Delete a subscription entitlement privilege","href":"/api-reference/entitlements/subscription-entitlements/delete-subscription-entitlement-privilege"},{"openapi":"GET /subscriptions/{external_id}/entitlements","title":"List subscription entitlements","href":"/api-reference/entitlements/subscription-entitlements/get-all-subscription-entitlements"}]},{"group":"Events","pages":[{"title":"The event object","href":"/api-reference/events/event-object"},{"openapi":"POST /events","title":"Send usage event","href":"/api-reference/events/usage"},{"openapi":"POST /events/batch","title":"Batch usage events","href":"/api-reference/events/batch"},{"openapi":"POST /events/estimate_fees","title":"Estimate an upcoming fee","href":"/api-reference/events/estimated-fee"},{"openapi":"GET /events/{transaction_id}","title":"Retrieve an event","href":"/api-reference/events/get-specific"},{"openapi":"GET /events","title":"List all events","href":"/api-reference/events/list-events"}]},{"group":"Fees","pages":[{"title":"The fee object","href":"/api-reference/fees/fee-object"},{"openapi":"PUT /fees/{lago_id}","title":"Update a fee","href":"/api-reference/fees/update-fee"},{"openapi":"DELETE /fees/{lago_id}","title":"Delete a fee","href":"/api-reference/fees/destroy-fee"},{"openapi":"GET /fees/{lago_id}","title":"Retrieve a fee","href":"/api-reference/fees/retrieve-fee"},{"openapi":"GET /fees","title":"List all fees","href":"/api-reference/fees/list-fees"}]},{"group":"Governance","pages":[{"title":"The governance entity object","href":"/api-reference/governance/entity-object"},{"openapi":"POST /usage_attribution_types","title":"Create a governance entity","href":"/api-reference/governance/create-entity"},{"openapi":"PUT /usage_attribution_types/{code}","title":"Update a governance entity","href":"/api-reference/governance/update-entity"},{"openapi":"DELETE /usage_attribution_types/{code}","title":"Delete a governance entity","href":"/api-reference/governance/delete-entity"},{"openapi":"GET /usage_attribution_types/{code}","title":"Retrieve a governance entity","href":"/api-reference/governance/get-specific-entity"},{"openapi":"GET /usage_attribution_types","title":"List all governance entities","href":"/api-reference/governance/get-all-entities"},{"title":"The attributed usage object","description":"This object represents the usage and spend of a subscription broken down by the values of one governance entity, one level of the tree at a time.","href":"/api-reference/governance/attributed-usage-object"},{"openapi":"GET /customers/{external_customer_id}/attributed_usage","title":"Retrieve attributed usage","href":"/api-reference/governance/get-attributed-usage"}]},{"group":"Invoices","pages":[{"title":"The invoice object","description":"This object represents an invoice generated by Lago for a specific customer. This invoice summarizes the fees generated by a subscription, usage-based charges, prepaid credit purchases, or one-off invoices.","href":"/api-reference/invoices/invoice-object"},{"openapi":"POST /invoices","title":"Create a one-off invoice","href":"/api-reference/invoices/create-oneoff"},{"openapi":"POST /invoices/preview","title":"Preview an invoice","href":"/api-reference/invoices/preview"},{"openapi":"POST /invoices/{lago_id}/download","title":"Download an invoice","href":"/api-reference/invoices/download"},{"openapi":"POST /invoices/{lago_id}/void","title":"Void an invoice","href":"/api-reference/invoices/void"},{"openapi":"POST /invoices/{lago_id}/retry","title":"Retry an invoice finalization","href":"/api-reference/invoices/retry_finalization"},{"openapi":"POST /invoices/{lago_id}/retry_payment","title":"Retry an invoice payment","href":"/api-reference/invoices/retry"},{"openapi":"POST /invoices/{lago_id}/payment_url","title":"Generate a payment URL","href":"/api-reference/invoices/payment-url"},{"openapi":"PUT /invoices/{lago_id}/refresh","title":"Refresh an invoice","href":"/api-reference/invoices/refresh"},{"openapi":"PUT /invoices/{lago_id}/finalize","title":"Finalize an invoice","href":"/api-reference/invoices/finalize"},{"openapi":"PUT /invoices/{lago_id}","title":"Update an invoice","href":"/api-reference/invoices/update"},{"openapi":"GET /invoices/{lago_id}","title":"Retrieve an invoice","href":"/api-reference/invoices/get-specific"},{"openapi":"GET /invoices","title":"List all invoices","href":"/api-reference/invoices/get-all"}]},{"group":"Organizations","pages":[{"title":"The organization object","href":"/api-reference/organizations/organization-object"},{"openapi":"PUT /organizations","title":"Update organization (deprecated)","href":"/api-reference/organizations/update"}]},{"group":"Payments","pages":[{"title":"The payment object","href":"/api-reference/payments/payment-object"},{"title":"Create a payment","openapi":"POST /payments","href":"/api-reference/payments/create"},{"title":"Retrieve a payment","openapi":"GET /payments/{lago_id}","href":"/api-reference/payments/get-specific"},{"title":"List all payments","openapi":"GET /payments","href":"/api-reference/payments/get-all"}]},{"group":"Payment methods","pages":[{"title":"The payment method object","href":"/api-reference/payment-methods/payment-method-object"},{"openapi":"PUT /customers/{external_customer_id}/payment_methods/{lago_id}/set_as_default","title":"Update a payment method","href":"/api-reference/payment-methods/update"},{"openapi":"DELETE /customers/{external_customer_id}/payment_methods/{lago_id}","title":"Delete a payment method from a customer","href":"/api-reference/payment-methods/delete"},{"openapi":"GET /customers/{external_customer_id}/payment_methods","title":"List all payment methods for a customer","href":"/api-reference/payment-methods/get-all"}]},{"group":"Payment receipts","pages":[{"title":"The payment receipt object","href":"/api-reference/payment-receipts/payment-receipt-object"},{"openapi":"GET /payment_receipts/{lago_id}","title":"Retrieve a payment receipt","href":"/api-reference/payment-receipts/get-specific"},{"openapi":"GET /payment_receipts","title":"List all payment receipts","href":"/api-reference/payment-receipts/get-all"}]},{"group":"Payment requests","pages":[{"title":"The payment request object","href":"/api-reference/payment-requests/payment-request-object"},{"title":"Create a payment request","openapi":"POST /payment_requests","href":"/api-reference/payment-requests/create"},{"title":"List all payment requests","openapi":"GET /payment_requests","href":"/api-reference/payment-requests/get-all"}]},{"group":"Plans","pages":[{"title":"The plan object","href":"/api-reference/plans/object"},{"title":"Create a plan","openapi":"POST /plans","href":"/api-reference/plans/create"},{"title":"Update a plan","openapi":"PUT /plans/{code}","href":"/api-reference/plans/update"},{"openapi":"DELETE /plans/{code}","title":"Delete a plan","href":"/api-reference/plans/destroy"},{"openapi":"GET /plans/{code}","title":"Retrieve a plan","href":"/api-reference/plans/get-specific"},{"openapi":"GET /plans","title":"List all plans","href":"/api-reference/plans/get-all-plans"},{"group":"Charges","pages":[{"title":"The charge object","href":"/api-reference/plans/charges/object"},{"title":"Create a charge","openapi":"POST /plans/{code}/charges","href":"/api-reference/plans/charges/create"},{"title":"Update a charge","openapi":"PUT /plans/{code}/charges/{charge_code}","href":"/api-reference/plans/charges/update"},{"title":"Delete a charge","openapi":"DELETE /plans/{code}/charges/{charge_code}","href":"/api-reference/plans/charges/destroy"},{"title":"Retrieve a charge","openapi":"GET /plans/{code}/charges/{charge_code}","href":"/api-reference/plans/charges/get-specific"},{"title":"List all charges","openapi":"GET /plans/{code}/charges","href":"/api-reference/plans/charges/get-all"},{"group":"Filters","pages":[{"title":"The charge filter object","href":"/api-reference/plans/charges/filters/object"},{"title":"Create a charge filter","openapi":"POST /plans/{code}/charges/{charge_code}/filters","href":"/api-reference/plans/charges/filters/create"},{"title":"Update a charge filter","openapi":"PUT /plans/{code}/charges/{charge_code}/filters/{filter_id}","href":"/api-reference/plans/charges/filters/update"},{"title":"Delete a charge filter","openapi":"DELETE /plans/{code}/charges/{charge_code}/filters/{filter_id}","href":"/api-reference/plans/charges/filters/destroy"},{"title":"Retrieve a charge filter","openapi":"GET /plans/{code}/charges/{charge_code}/filters/{filter_id}","href":"/api-reference/plans/charges/filters/get-specific"},{"title":"List all charge filters","openapi":"GET /plans/{code}/charges/{charge_code}/filters","href":"/api-reference/plans/charges/filters/get-all"}]}]},{"group":"Fixed Charges","pages":[{"title":"The fixed charge object","href":"/api-reference/plans/fixed-charges/object"},{"title":"Create a fixed charge","openapi":"POST /plans/{code}/fixed_charges","href":"/api-reference/plans/fixed-charges/create"},{"title":"Update a fixed charge","openapi":"PUT /plans/{code}/fixed_charges/{fixed_charge_code}","href":"/api-reference/plans/fixed-charges/update"},{"title":"Delete a fixed charge","openapi":"DELETE /plans/{code}/fixed_charges/{fixed_charge_code}","href":"/api-reference/plans/fixed-charges/destroy"},{"title":"Retrieve a fixed charge","openapi":"GET /plans/{code}/fixed_charges/{fixed_charge_code}","href":"/api-reference/plans/fixed-charges/get-specific"},{"title":"List all fixed charges","openapi":"GET /plans/{code}/fixed_charges","href":"/api-reference/plans/fixed-charges/get-all"}]}]},{"group":"Quotes \u0026 Order forms","pages":[{"group":"Quotes","pages":[{"title":"The quote object","href":"/api-reference/quotes/quote-object"},{"title":"The quote version object","href":"/api-reference/quotes/quote-version-object"},{"openapi":"POST /quote_versions/{lago_id}/approve","title":"Approve a quote version","href":"/api-reference/quotes/approve-version"},{"openapi":"POST /quote_versions/{lago_id}/void","title":"Void a quote version","href":"/api-reference/quotes/void-version"},{"openapi":"POST /quote_versions/{lago_id}/clone","title":"Clone a quote version","href":"/api-reference/quotes/clone-version"},{"openapi":"GET /quotes/{lago_id}","title":"Retrieve a quote","href":"/api-reference/quotes/get-specific"},{"openapi":"GET /quotes","title":"List all quotes","href":"/api-reference/quotes/get-all"},{"openapi":"GET /quote_versions/{lago_id}","title":"Retrieve a quote version","href":"/api-reference/quotes/get-specific-version"},{"openapi":"GET /quotes/{lago_id}/versions","title":"List all versions of a quote","href":"/api-reference/quotes/get-all-versions"}]},{"group":"Order forms","pages":[{"title":"The order form object","href":"/api-reference/quotes/order-forms/order-form-object"},{"openapi":"POST /order_forms/{lago_id}/mark_as_signed","title":"Mark an order form as signed","href":"/api-reference/quotes/order-forms/mark-as-signed"},{"openapi":"POST /order_forms/{lago_id}/void","title":"Void an order form","href":"/api-reference/quotes/order-forms/void"},{"openapi":"GET /order_forms/{lago_id}","title":"Retrieve an order form","href":"/api-reference/quotes/order-forms/get-specific"},{"openapi":"GET /order_forms","title":"List all order forms","href":"/api-reference/quotes/order-forms/get-all"}]},{"group":"Orders","pages":[{"title":"The order object","href":"/api-reference/quotes/orders/order-object"},{"openapi":"POST /orders/{lago_id}/execute","title":"Execute an order","href":"/api-reference/quotes/orders/execute"},{"openapi":"GET /orders/{lago_id}","title":"Retrieve an order","href":"/api-reference/quotes/orders/get-specific"},{"openapi":"GET /orders","title":"List all orders","href":"/api-reference/quotes/orders/get-all"}]}]},{"group":"Resources","pages":[{"title":"Currencies","href":"/api-reference/resources/currencies"},{"title":"Timezones","href":"/api-reference/resources/timezones"},{"title":"Document locales","href":"/api-reference/resources/locales"}]},{"group":"Subscriptions","pages":[{"title":"The subscription object","href":"/api-reference/subscriptions/subscription-object"},{"title":"Create a subscription","openapi":"POST /subscriptions","href":"/api-reference/subscriptions/assign-plan"},{"title":"Update a subscription","openapi":"PUT /subscriptions/{external_id}","href":"/api-reference/subscriptions/update"},{"title":"Terminate a subscription","openapi":"DELETE /subscriptions/{external_id}","href":"/api-reference/subscriptions/terminate"},{"title":"Retrieve a subscription","openapi":"GET /subscriptions/{external_id}","href":"/api-reference/subscriptions/get-specific"},{"title":"List all subscriptions","openapi":"GET /subscriptions","href":"/api-reference/subscriptions/get-all"},{"group":"Lifetime Usage","pages":[{"title":"The lifetime usage object","href":"/api-reference/subscriptions/lifetime-usage-object"},{"title":"Update subscription lifetime usage","openapi":"PUT /subscriptions/{external_id}/lifetime_usage","href":"/api-reference/subscriptions/update-lifetime-usage"},{"title":"Retrieve subscription lifetime usage","openapi":"GET /subscriptions/{external_id}/lifetime_usage","href":"/api-reference/subscriptions/get-lifetime-usage"}]},{"group":"Charges","pages":[{"title":"The charge object","href":"/api-reference/subscriptions/charges/object"},{"title":"Update a charge","openapi":"PUT /subscriptions/{external_id}/charges/{charge_code}","href":"/api-reference/subscriptions/charges/update"},{"title":"Retrieve a charge","openapi":"GET /subscriptions/{external_id}/charges/{charge_code}","href":"/api-reference/subscriptions/charges/get-specific"},{"title":"List all charges","openapi":"GET /subscriptions/{external_id}/charges","href":"/api-reference/subscriptions/charges/get-all"},{"group":"Filters","pages":[{"title":"The charge filter object","href":"/api-reference/subscriptions/charges/filters/object"},{"title":"Create a charge filter","openapi":"POST /subscriptions/{external_id}/charges/{charge_code}/filters","href":"/api-reference/subscriptions/charges/filters/create"},{"title":"Update a charge filter","openapi":"PUT /subscriptions/{external_id}/charges/{charge_code}/filters/{filter_id}","href":"/api-reference/subscriptions/charges/filters/update"},{"title":"Delete a charge filter","openapi":"DELETE /subscriptions/{external_id}/charges/{charge_code}/filters/{filter_id}","href":"/api-reference/subscriptions/charges/filters/destroy"},{"title":"Retrieve a charge filter","openapi":"GET /subscriptions/{external_id}/charges/{charge_code}/filters/{filter_id}","href":"/api-reference/subscriptions/charges/filters/get-specific"},{"title":"List all charge filters","openapi":"GET /subscriptions/{external_id}/charges/{charge_code}/filters","href":"/api-reference/subscriptions/charges/filters/get-all"}]}]},{"group":"Fixed Charges","pages":[{"title":"The fixed charge object","href":"/api-reference/subscriptions/fixed-charges/object"},{"title":"Update a fixed charge","openapi":"PUT /subscriptions/{external_id}/fixed_charges/{fixed_charge_code}","href":"/api-reference/subscriptions/fixed-charges/update"},{"title":"Retrieve a fixed charge","openapi":"GET /subscriptions/{external_id}/fixed_charges/{fixed_charge_code}","href":"/api-reference/subscriptions/fixed-charges/get-specific"},{"title":"List all fixed charges","openapi":"GET /subscriptions/{external_id}/fixed_charges","href":"/api-reference/subscriptions/fixed-charges/get-all"}]}]},{"group":"Taxes","pages":[{"title":"The tax object","href":"/api-reference/taxes/tax-object"},{"openapi":"POST /taxes","title":"Create a tax rate","href":"/api-reference/taxes/create"},{"openapi":"PUT /taxes/{code}","title":"Update a tax rate","href":"/api-reference/taxes/update"},{"openapi":"DELETE /taxes/{code}","title":"Delete a tax rate","href":"/api-reference/taxes/destroy"},{"openapi":"GET /taxes/{code}","title":"Retrieve a tax rate","href":"/api-reference/taxes/get-specific"},{"openapi":"GET /taxes","title":"List all tax rates","href":"/api-reference/taxes/get-all"}]},{"group":"Wallets","pages":[{"title":"The wallet object","href":"/api-reference/wallets/wallet-object"},{"openapi":"POST /wallets","title":"Create a wallet","href":"/api-reference/wallets/create"},{"openapi":"PUT /wallets/{lago_id}","title":"Update a wallet","href":"/api-reference/wallets/update"},{"openapi":"DELETE /wallets/{lago_id}","title":"Terminate a wallet","href":"/api-reference/wallets/terminate"},{"openapi":"GET /wallets/{lago_id}","title":"Retrieve a wallet","href":"/api-reference/wallets/get-specific"},{"openapi":"GET /wallets","title":"List all wallets","href":"/api-reference/wallets/get-all"},{"group":"Wallets by code","pages":[{"openapi":"POST /customers/{external_customer_id}/wallets","title":"Create a wallet for a customer","href":"/api-reference/wallets/create-for-customer"},{"openapi":"PUT /customers/{external_customer_id}/wallets/{code}","title":"Update a wallet by code","href":"/api-reference/wallets/update-by-code"},{"openapi":"DELETE /customers/{external_customer_id}/wallets/{code}","title":"Terminate a wallet by code","href":"/api-reference/wallets/terminate-by-code"},{"openapi":"GET /customers/{external_customer_id}/wallets/{code}","title":"Retrieve a wallet by code","href":"/api-reference/wallets/get-specific-by-code"},{"openapi":"GET /customers/{external_customer_id}/wallets","title":"List all wallets for a customer","href":"/api-reference/wallets/get-all-for-customer"}]},{"group":"Wallet transactions","pages":[{"title":"The wallet transaction object","href":"/api-reference/wallets/wallet-transaction-object"},{"openapi":"POST /wallet_transactions","title":"Top-up a wallet","href":"/api-reference/wallets/top-up"},{"openapi":"POST /wallet_transactions/{lago_id}/payment_url","title":"Generate a payment URL","href":"/api-reference/wallets/wallet-transaction-payment-url"},{"openapi":"GET /wallet_transactions/{lago_id}","title":"Retrieve a transaction","href":"/api-reference/wallets/get-specific-transaction"},{"openapi":"GET /wallets/{lago_id}/wallet_transactions","title":"List all wallet transactions","href":"/api-reference/wallets/get-all-transactions"},{"openapi":"GET /wallet_transactions/{lago_id}/consumptions","title":"List all consumptions for a wallet transaction","href":"/api-reference/wallets/get-all-consumptions"},{"openapi":"GET /wallet_transactions/{lago_id}/fundings","title":"List all fundings for a wallet transaction","href":"/api-reference/wallets/get-all-fundings"}]},{"group":"Wallet alerts","pages":[{"title":"The wallet alert object","href":"/api-reference/wallets/wallet-alert-object"},{"openapi":"POST /customers/{external_customer_id}/wallets/{wallet_code}/alerts","title":"Create a wallet alert","href":"/api-reference/wallets/create-alert"},{"openapi":"PUT /customers/{external_customer_id}/wallets/{wallet_code}/alerts/{code}","title":"Update a wallet alert","href":"/api-reference/wallets/update-alert"},{"openapi":"DELETE /customers/{external_customer_id}/wallets/{wallet_code}/alerts/{code}","title":"Delete a wallet alert","href":"/api-reference/wallets/delete-alert"},{"openapi":"GET /customers/{external_customer_id}/wallets/{wallet_code}/alerts/{code}","title":"Retrieve a wallet alert","href":"/api-reference/wallets/get-specific-alert"},{"openapi":"GET /customers/{external_customer_id}/wallets/{wallet_code}/alerts","title":"List all wallet alerts","href":"/api-reference/wallets/get-all-alerts"}]}]},{"group":"Webhook endpoints","pages":[{"title":"The webhook endpoint object","href":"/api-reference/webhook-endpoints/webhook-endpoint-object"},{"openapi":"POST /webhook_endpoints","title":"Create a webhook endpoint","href":"/api-reference/webhook-endpoints/create"},{"openapi":"PUT /webhook_endpoints/{lago_id}","title":"Update a webhook endpoint","href":"/api-reference/webhook-endpoints/update"},{"openapi":"DELETE /webhook_endpoints/{lago_id}","title":"Delete a webhook endpoint","href":"/api-reference/webhook-endpoints/destroy"},{"openapi":"GET /webhook_endpoints","title":"List all webhook endpoints","href":"/api-reference/webhook-endpoints/get-all"},{"openapi":"GET /webhook_endpoints/{lago_id}","title":"Retrieve a webhook endpoint","href":"/api-reference/webhook-endpoints/get-specific"}]},{"group":"Webhooks","pages":[{"title":"Format and signature","href":"/api-reference/webhooks/format---signature"},{"title":"Messages","href":"/api-reference/webhooks/messages"}]}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/introduction"}]},{"tab":"Templates","pages":[{"title":"Templates","href":"/templates/introduction"}]},{"tab":"FAQ","pages":[{"title":"FAQ","href":"/faq/about-lago"}]},{"tab":"Knowledge Base","href":"https://knowledge.getlago.com"},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/product"}]}]},"basePath":"","title":"Retrieve attributed usage - Lago","buildId":"dpl_3pZeXn3XukjzFRgAX73A7GNDfRJ1","deploymentId":"dpl_3pZeXn3XukjzFRgAX73A7GNDfRJ1","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CW3yP2DK.js","utils-BN0nty2W.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C8_MydSG.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bsl5xDMQ.js","snippetPresets-DYv9OBej.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-9OnYPrVf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-xr67xWGO.js","shallow-DO1aDdBF.js","getApiPlaygroundDisplay-o7cLzFL-.js","CodeSnippet-CGr2yOA8.js","CodeSnippets-CzBbqPNh.js","Page-CBlOSKZG.js","getPastedJson-dpi9sn5Y.js","icon-aIWHt8Pn.js","MethodPill-Bv2zLsGY.js","DuplicateIcon-DxFSz0J6.js","createIcon-uDNv6jwj.js","DynamicMarkdown-C91yhnNP.js","SectionHeading-DG_xjOLR.js","axios-vUo_bRtp.js","Markdown-B4M_Eo1P.js","clsx-DShopWo_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BX6wab7q.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-48h67xm_.js"]}