List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.
GET
/
billing
/
invoices
JavaScript
import DodoPayments from 'dodopayments';
const client = new DodoPayments({
bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});
// Automatically fetches more pages as needed.
for await (const invoice of client.invoices.list()) {
console.log(invoice.amount_paid);
}
import os
from dodopayments import DodoPayments
client = DodoPayments(
bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"), # This is the default and can be omitted
)
page = client.invoices.list()
page = page.items[0]
print(page.amount_paid)
Send your API key as a bearer token: Authorization: Bearer <api_key>. A test mode key starts with dodo_test_, for example dodo_test_AbCd1234EfGh5678.<secret>. A live mode key starts with dodo_live_. Use a test mode key on test.dodopayments.com and a live mode key on live.dodopayments.com. Keys from before these tags have no tag and operate as before.
import DodoPayments from 'dodopayments';
const client = new DodoPayments({
bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});
// Automatically fetches more pages as needed.
for await (const invoice of client.invoices.list()) {
console.log(invoice.amount_paid);
}
import os
from dodopayments import DodoPayments
client = DodoPayments(
bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"), # This is the default and can be omitted
)
page = client.invoices.list()
page = page.items[0]
print(page.amount_paid)
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Dodo Payments Documentation","description":"Documentation for Dodo Payments — the all-in-one payments, billing, and merchant of record platform for SaaS, AI, and digital products.","colors":{"primary":"#779812","light":"#C6FE1E","dark":"#166534"},"logo":{"light":"https://mintcdn.com/dodopayments/nM_mJfYkri-OpC5M/logo/light.svg?fit=max\u0026auto=format\u0026n=nM_mJfYkri-OpC5M\u0026q=85\u0026s=23f7a052f7ecb9d6570b7c95ee359a97","dark":"https://mintcdn.com/dodopayments/nM_mJfYkri-OpC5M/logo/dark.svg?fit=max\u0026auto=format\u0026n=nM_mJfYkri-OpC5M\u0026q=85\u0026s=cd6c20238a54526436f21c43fee51b26"},"favicon":"https://mintcdn.com/dodopayments/doYQc9oUE-WNz0cs/favicon.svg?fit=max\u0026auto=format\u0026n=doYQc9oUE-WNz0cs\u0026q=85\u0026s=271c6cc8ce7d6bf4d7f2b9cca029e004","background":{"color":{"light":"#FFFFFF","dark":"#0D0D0D"}},"navbar":{"links":[{"icon":"link","href":"https://docs.dodopayments.com/llms-full.txt","label":"llms-full.txt"},{"icon":"discord","href":"https://discord.gg/bYqAp4ayYh","label":"Community"},{"icon":"house","href":"https://app.dodopayments.com/","label":"Dashboard"}]},"footer":{"socials":{"x":"https://x.com/dodopayments","linkedin":"https://linkedin.com/company/dodopayments","website":"https://dodopayments.com","discord":"https://discord.gg/bYqAp4ayYh","github":"https://github.com/dodopayments","instagram":"https://www.instagram.com/dodo.payments","facebook":"https://www.facebook.com/profile.php?id=61565515607280"}},"seo":{"metatags":{"og:site_name":"Dodo Payments Documentation","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"heading":{"family":"ApfelGrotezk","weight":400,"source":"fonts/ApfelGrotezk-Regular.woff2","format":"woff2"},"body":{"family":"Inter","weight":400,"source":"fonts/Inter-Variable.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"ar","href":"ar/introduction"},{"language":"fr","href":"fr/introduction"},{"language":"de","href":"de/introduction"},{"language":"id","href":"id/introduction"},{"language":"ja","href":"ja/introduction"},{"language":"ko","href":"ko/introduction"},{"language":"pt-BR","href":"pt-BR/introduction"},{"language":"vi","href":"vi/introduction"},{"language":"cn","href":"cn/introduction"},{"language":"hi","href":"hi/introduction"},{"language":"it","href":"it/introduction"},{"language":"sv","href":"sv/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dodopayments","hasAudioNarration":false,"actualSubdomain":"dodopayments","customDomains":["docs.dodopayments.com"],"gitSource":{"type":"github","owner":"dodopayments","repo":"dodo-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af2d0a118316a0dfc1e077b","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"en","tag":"API Reference","count":181},{"language":"en","tag":"Docs","count":175},{"language":"ar","tag":"Docs","count":153},{"language":"cn","tag":"Docs","count":153},{"language":"de","tag":"Docs","count":153},{"language":"es","tag":"Docs","count":153},{"language":"fr","tag":"Docs","count":153},{"language":"hi","tag":"Docs","count":153},{"language":"id","tag":"Docs","count":153},{"language":"it","tag":"Docs","count":153},{"language":"ja","tag":"Docs","count":153},{"language":"ko","tag":"Docs","count":153},{"language":"pt-BR","tag":"Docs","count":153},{"language":"sv","tag":"Docs","count":153},{"language":"vi","tag":"Docs","count":153},{"language":"ar","tag":"API Reference","count":151},{"language":"cn","tag":"API Reference","count":151},{"language":"de","tag":"API Reference","count":151},{"language":"es","tag":"API Reference","count":151},{"language":"fr","tag":"API Reference","count":151},{"language":"hi","tag":"API Reference","count":151},{"language":"id","tag":"API Reference","count":151},{"language":"it","tag":"API Reference","count":151},{"language":"ja","tag":"API Reference","count":151},{"language":"ko","tag":"API Reference","count":151},{"language":"pt-BR","tag":"API Reference","count":151},{"language":"sv","tag":"API Reference","count":151},{"language":"vi","tag":"API Reference","count":151},{"language":"en","tag":"Features","count":85},{"language":"ar","tag":"Features","count":81},{"language":"cn","tag":"Features","count":81},{"language":"de","tag":"Features","count":81},{"language":"es","tag":"Features","count":81},{"language":"fr","tag":"Features","count":81},{"language":"hi","tag":"Features","count":81},{"language":"id","tag":"Features","count":81},{"language":"it","tag":"Features","count":81},{"language":"ja","tag":"Features","count":81},{"language":"ko","tag":"Features","count":81},{"language":"pt-BR","tag":"Features","count":81},{"language":"sv","tag":"Features","count":81},{"language":"vi","tag":"Features","count":81},{"language":"en","tag":"Integrate","count":74},{"language":"en","tag":"Changelog","count":66},{"language":"ar","tag":"Changelog","count":65},{"language":"cn","tag":"Changelog","count":65},{"language":"de","tag":"Changelog","count":65},{"language":"es","tag":"Changelog","count":65},{"language":"fr","tag":"Changelog","count":65},{"language":"hi","tag":"Changelog","count":65},{"language":"id","tag":"Changelog","count":65},{"language":"it","tag":"Changelog","count":65},{"language":"ja","tag":"Changelog","count":65},{"language":"ko","tag":"Changelog","count":65},{"language":"pt-BR","tag":"Changelog","count":65},{"language":"sv","tag":"Changelog","count":65},{"language":"vi","tag":"Changelog","count":65},{"language":"ar","tag":"Integrate","count":59},{"language":"cn","tag":"Integrate","count":59},{"language":"de","tag":"Integrate","count":59},{"language":"es","tag":"Integrate","count":59},{"language":"fr","tag":"Integrate","count":59},{"language":"hi","tag":"Integrate","count":59},{"language":"id","tag":"Integrate","count":59},{"language":"it","tag":"Integrate","count":59},{"language":"ja","tag":"Integrate","count":59},{"language":"ko","tag":"Integrate","count":59},{"language":"pt-BR","tag":"Integrate","count":59},{"language":"sv","tag":"Integrate","count":59},{"language":"vi","tag":"Integrate","count":59},{"language":"en","tag":"External Integrations","count":33},{"language":"ar","tag":"External Integrations","count":30},{"language":"cn","tag":"External Integrations","count":30},{"language":"de","tag":"External Integrations","count":30},{"language":"es","tag":"External Integrations","count":30},{"language":"fr","tag":"External Integrations","count":30},{"language":"hi","tag":"External Integrations","count":30},{"language":"id","tag":"External Integrations","count":30},{"language":"it","tag":"External Integrations","count":30},{"language":"ja","tag":"External Integrations","count":30},{"language":"ko","tag":"External Integrations","count":30},{"language":"pt-BR","tag":"External Integrations","count":30},{"language":"sv","tag":"External Integrations","count":30},{"language":"vi","tag":"External Integrations","count":30},{"language":"en","tag":"Webhooks","count":23},{"language":"ar","tag":"Webhooks","count":23},{"language":"cn","tag":"Webhooks","count":23},{"language":"de","tag":"Webhooks","count":23},{"language":"es","tag":"Webhooks","count":23},{"language":"fr","tag":"Webhooks","count":23},{"language":"hi","tag":"Webhooks","count":23},{"language":"id","tag":"Webhooks","count":23},{"language":"it","tag":"Webhooks","count":23},{"language":"ja","tag":"Webhooks","count":23},{"language":"ko","tag":"Webhooks","count":23},{"language":"pt-BR","tag":"Webhooks","count":23},{"language":"sv","tag":"Webhooks","count":23},{"language":"vi","tag":"Webhooks","count":23},{"language":"en","tag":"Guides","count":22},{"language":"ar","tag":"Guides","count":22},{"language":"cn","tag":"Guides","count":22},{"language":"de","tag":"Guides","count":22},{"language":"es","tag":"Guides","count":22},{"language":"fr","tag":"Guides","count":22},{"language":"hi","tag":"Guides","count":22},{"language":"id","tag":"Guides","count":22},{"language":"it","tag":"Guides","count":22},{"language":"ja","tag":"Guides","count":22},{"language":"ko","tag":"Guides","count":22},{"language":"pt-BR","tag":"Guides","count":22},{"language":"sv","tag":"Guides","count":22},{"language":"vi","tag":"Guides","count":22},{"language":"en","tag":"Entitlements","count":20},{"language":"ar","tag":"Entitlements","count":20},{"language":"cn","tag":"Entitlements","count":20},{"language":"de","tag":"Entitlements","count":20},{"language":"es","tag":"Entitlements","count":20},{"language":"fr","tag":"Entitlements","count":20},{"language":"hi","tag":"Entitlements","count":20},{"language":"id","tag":"Entitlements","count":20},{"language":"it","tag":"Entitlements","count":20},{"language":"ja","tag":"Entitlements","count":20},{"language":"ko","tag":"Entitlements","count":20},{"language":"pt-BR","tag":"Entitlements","count":20},{"language":"sv","tag":"Entitlements","count":20},{"language":"vi","tag":"Entitlements","count":20},{"language":"en","tag":"Invoices","count":17},{"language":"ar","tag":"Customers","count":16},{"language":"cn","tag":"Customers","count":16},{"language":"de","tag":"Customers","count":16},{"language":"es","tag":"Customers","count":16},{"language":"fr","tag":"Customers","count":16},{"language":"hi","tag":"Customers","count":16},{"language":"id","tag":"Customers","count":16},{"language":"it","tag":"Customers","count":16},{"language":"ja","tag":"Customers","count":16},{"language":"ko","tag":"Customers","count":16},{"language":"pt-BR","tag":"Customers","count":16},{"language":"sv","tag":"Customers","count":16},{"language":"vi","tag":"Customers","count":16}]},"assistantConfig":{"deflection":{"enabled":false,"email":"support@dodopayments.com","showHelpButton":true}},"basePath":"","hasChatPermissions":false,"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":"styles.css","content":"#content-area{max-width:60rem}h1,h2,h3,h4,h5,h6{letter-spacing:0.05em!important}.welcome-page .card-group{margin:3rem auto 8rem;max-width:70rem;padding-left:1.25rem;padding-right:1.25rem}.welcome-page .card-group .card{padding:1rem}.welcome-hero{display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:20vh;text-align:center;margin-top:3rem;margin-bottom:2.5rem}.welcome-hero h1{font-size:2.5rem;font-weight:700;margin-bottom:1rem;line-height:1.2;color:#fff}.welcome-hero p{font-size:1.25rem;max-width:600px;margin:0 auto}.welcome-hero h1{color:rgb(41 42 37 / 1)}.dark .welcome-hero h1{color:rgb(255 255 255 / 1)}.welcome-hero p{color:rgb(83 85 79 / 1)}.dark .welcome-hero p{color:rgb(162 164 158 / 1)}"}],"page":{"pagePath":"api-reference/invoices/list-invoices","slug":"/api-reference/invoices/list-invoices","pageMetadata":{"openapi":"get /billing/invoices","title":"List Invoices","description":"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.","keywords":["Dodo Payments","API reference","REST API","list invoices"],"href":"/api-reference/invoices/list-invoices"},"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: \"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.\"\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":{"config":{},"pageMetadata":{"openapi":"get /billing/invoices","title":"List Invoices","description":"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.","keywords":["Dodo Payments","API reference","REST API","list invoices"],"href":"/api-reference/invoices/list-invoices"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/dodopayments/0ee82a08f7b65bcb/seo.js","/_mintlify/custom/dodopayments/6f88c9bbee313616/assistant-loader.js"],"openApiReferenceData":{"operation":{"tags":["Invoices"],"summary":"List invoices","description":"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.","operationId":"list_invoices","parameters":["69bfcda5-43b0-41f7-b9ba-60757d674cab","5d1fa8b5-8dba-4a54-8818-dcef277a0490","b864e9f5-5ad8-4073-8294-eb941161658c","a4216d04-8f68-4103-b8ba-1b38050c00bf","0e3cefdb-fa29-4c5f-aafa-5a0a74d95840","f715d445-66c8-4f47-b229-e6bf14b4cf64","051405fe-c887-4ae6-99e9-f937dd1d77f9","bba1b654-6268-4fa1-a2f2-2e68c3cc6a8c","aea7f220-2937-4b92-860f-627400b5ab81","da89dbf8-5725-4aef-8174-71d9d509a4a7","cb791cdb-4c4f-401e-980e-1003590b47b3","dab8b0fd-d3a0-42cc-85f4-e9284e41b32a","1ce12c6c-53cd-49e3-ae0b-902d2918c4d7"],"responses":{"200":"c6bd0b53-2118-4c38-853b-ba2f6aa8ae3c","400":"459bda64-55f9-406e-a774-bd7cb66ed6eb","500":"c0a89b1b-30db-46f2-b14f-c521e2f2b018"},"security":["9337a13b-b8f7-45ee-9f19-7c7217e4c607"],"x-codeSamples":[{"lang":"JavaScript","source":"import DodoPayments from 'dodopayments';\n\nconst client = new DodoPayments({\n bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted\n});\n\n// Automatically fetches more pages as needed.\nfor await (const invoice of client.invoices.list()) {\n console.log(invoice.amount_paid);\n}"},{"lang":"Python","source":"import os\nfrom dodopayments import DodoPayments\n\nclient = DodoPayments(\n bearer_token=os.environ.get(\"DODO_PAYMENTS_API_KEY\"), # This is the default and can be omitted\n)\npage = client.invoices.list()\npage = page.items[0]\nprint(page.amount_paid)"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/dodopayments/dodopayments-go\"\n\t\"github.com/dodopayments/dodopayments-go/option\"\n)\n\nfunc main() {\n\tclient := dodopayments.NewClient(\n\t\toption.WithBearerToken(\"My Bearer Token\"),\n\t)\n\tpage, err := client.Invoices.List(context.TODO(), dodopayments.InvoiceListParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", page)\n}\n"},{"lang":"Java","source":"package com.dodopayments.api.example;\n\nimport com.dodopayments.api.client.DodoPaymentsClient;\nimport com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;\nimport com.dodopayments.api.models.invoices.InvoiceListPage;\nimport com.dodopayments.api.models.invoices.InvoiceListParams;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();\n\n InvoiceListPage page = client.invoices().list();\n }\n}"},{"lang":"Kotlin","source":"package com.dodopayments.api.example\n\nimport com.dodopayments.api.client.DodoPaymentsClient\nimport com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient\nimport com.dodopayments.api.models.invoices.InvoiceListPage\nimport com.dodopayments.api.models.invoices.InvoiceListParams\n\nfun main() {\n val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()\n\n val page: InvoiceListPage = client.invoices().list()\n}"},{"lang":"Ruby","source":"require \"dodopayments\"\n\ndodo_payments = Dodopayments::Client.new(\n bearer_token: \"My Bearer Token\",\n environment: \"test_mode\" # defaults to \"live_mode\"\n)\n\npage = dodo_payments.invoices.list\n\nputs(page)"},{"lang":"PHP","source":"\u003c?php\n\nrequire_once dirname(__DIR__) . '/vendor/autoload.php';\n\nuse Dodopayments\\Client;\nuse Dodopayments\\Core\\Exceptions\\APIException;\n\n$client = new Client(\n bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',\n environment: 'test_mode',\n);\n\ntry {\n $page = $client->invoices->list(\n collectionMethod: 'auto_charge',\n createdAtGte: new \\DateTimeImmutable('2019-12-27T18:11:19.117Z'),\n createdAtLte: new \\DateTimeImmutable('2019-12-27T18:11:19.117Z'),\n customerID: 'customer_id',\n dueAtGte: new \\DateTimeImmutable('2019-12-27T18:11:19.117Z'),\n dueAtLte: new \\DateTimeImmutable('2019-12-27T18:11:19.117Z'),\n pageNumber: 0,\n pageSize: 0,\n status: ['open'],\n subscriptionID: 'subscription_id',\n tags: ['refunded'],\n totalAmountGte: 0,\n totalAmountLte: 0,\n );\n\n var_dump($page);\n} catch (APIException $e) {\n echo $e->getMessage();\n}"},{"lang":"C#","source":"using System;\nusing DodoPayments.Client;\nusing DodoPayments.Client.Models.Invoices;\n\nDodoPaymentsClient client = new();\n\nInvoiceListParams parameters = new();\n\nvar page = await client.Invoices.List(parameters);\nawait foreach (var item in page.Paginate())\n{\n Console.WriteLine(item);\n}"},{"lang":"Rust","source":"use dodopayments::Client;\n\n#[tokio::main]\nasync fn main() -> dodopayments::Result\u003c()> {\n let client = Client::from_env()?;\n let result = client\n .invoices()\n .list()\n .query(serde_json::json!({}))\n .await?;\n println!(\"{result:?}\");\n Ok(())\n}"}],"method":"get","type":"path","servers":["258c6c34-2f0b-4091-a5e0-d5c0da1d0e4f","5001ffd6-aa75-47ac-b009-c76c158d0a43"],"path":"/billing/invoices","baseUrlOptions":["https://test.dodopayments.com/","https://live.dodopayments.com/"],"title":"List invoices","codeSamples":[{"lang":"JavaScript","source":"import DodoPayments from 'dodopayments';\n\nconst client = new DodoPayments({\n bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted\n});\n\n// Automatically fetches more pages as needed.\nfor await (const invoice of client.invoices.list()) {\n console.log(invoice.amount_paid);\n}"},{"lang":"Python","source":"import os\nfrom dodopayments import DodoPayments\n\nclient = DodoPayments(\n bearer_token=os.environ.get(\"DODO_PAYMENTS_API_KEY\"), # This is the default and can be omitted\n)\npage = client.invoices.list()\npage = page.items[0]\nprint(page.amount_paid)"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/dodopayments/dodopayments-go\"\n\t\"github.com/dodopayments/dodopayments-go/option\"\n)\n\nfunc main() {\n\tclient := dodopayments.NewClient(\n\t\toption.WithBearerToken(\"My Bearer Token\"),\n\t)\n\tpage, err := client.Invoices.List(context.TODO(), dodopayments.InvoiceListParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", page)\n}\n"},{"lang":"Java","source":"package com.dodopayments.api.example;\n\nimport com.dodopayments.api.client.DodoPaymentsClient;\nimport com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;\nimport com.dodopayments.api.models.invoices.InvoiceListPage;\nimport com.dodopayments.api.models.invoices.InvoiceListParams;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();\n\n InvoiceListPage page = client.invoices().list();\n }\n}"},{"lang":"Kotlin","source":"package com.dodopayments.api.example\n\nimport com.dodopayments.api.client.DodoPaymentsClient\nimport com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient\nimport com.dodopayments.api.models.invoices.InvoiceListPage\nimport com.dodopayments.api.models.invoices.InvoiceListParams\n\nfun main() {\n val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()\n\n val page: InvoiceListPage = client.invoices().list()\n}"},{"lang":"Ruby","source":"require \"dodopayments\"\n\ndodo_payments = Dodopayments::Client.new(\n bearer_token: \"My Bearer Token\",\n environment: \"test_mode\" # defaults to \"live_mode\"\n)\n\npage = dodo_payments.invoices.list\n\nputs(page)"},{"lang":"PHP","source":"\u003c?php\n\nrequire_once dirname(__DIR__) . '/vendor/autoload.php';\n\nuse Dodopayments\\Client;\nuse Dodopayments\\Core\\Exceptions\\APIException;\n\n$client = new Client(\n bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',\n environment: 'test_mode',\n);\n\ntry {\n $page = $client->invoices->list(\n collectionMethod: 'auto_charge',\n createdAtGte: new \\DateTimeImmutable('2019-12-27T18:11:19.117Z'),\n createdAtLte: new \\DateTimeImmutable('2019-12-27T18:11:19.117Z'),\n customerID: 'customer_id',\n dueAtGte: new \\DateTimeImmutable('2019-12-27T18:11:19.117Z'),\n dueAtLte: new \\DateTimeImmutable('2019-12-27T18:11:19.117Z'),\n pageNumber: 0,\n pageSize: 0,\n status: ['open'],\n subscriptionID: 'subscription_id',\n tags: ['refunded'],\n totalAmountGte: 0,\n totalAmountLte: 0,\n );\n\n var_dump($page);\n} catch (APIException $e) {\n echo $e->getMessage();\n}"},{"lang":"C#","source":"using System;\nusing DodoPayments.Client;\nusing DodoPayments.Client.Models.Invoices;\n\nDodoPaymentsClient client = new();\n\nInvoiceListParams parameters = new();\n\nvar page = await client.Invoices.List(parameters);\nawait foreach (var item in page.Paginate())\n{\n Console.WriteLine(item);\n}"},{"lang":"Rust","source":"use dodopayments::Client;\n\n#[tokio::main]\nasync fn main() -> dodopayments::Result\u003c()> {\n let client = Client::from_env()?;\n let result = client\n .invoices()\n .list()\n .query(serde_json::json!({}))\n .await?;\n println!(\"{result:?}\");\n Ok(())\n}"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"69bfcda5-43b0-41f7-b9ba-60757d674cab":{"name":"status","in":"query","description":"Repeat the key to match more than one status, for example `status=open\u0026status=past_due`.","required":false,"schema":{"type":"array","items":{"type":"string","description":"The `message` of each variant is the label of the invoice document.","enum":["open","paid","void","draft","past_due","uncollectable"],"uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":false,"description":"Repeat the key to match more than one status, for example `status=open\u0026status=past_due`.","uniqueKey":"","typeLabel":"enum\u003cstring>[]"},"style":"form"},"5d1fa8b5-8dba-4a54-8818-dcef277a0490":{"name":"tags","in":"query","description":"Repeat the key to match an invoice that has any one of the tags.","required":false,"schema":{"type":"array","items":{"type":"string","enum":["refunded","partially_refunded","disputed","payment_reversed"],"uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":false,"description":"Repeat the key to match an invoice that has any one of the tags.","uniqueKey":"","typeLabel":"enum\u003cstring>[]"},"style":"form"},"b864e9f5-5ad8-4073-8294-eb941161658c":{"name":"customer_id","in":"query","required":false,"schema":{"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"},"style":"form"},"a4216d04-8f68-4103-b8ba-1b38050c00bf":{"name":"subscription_id","in":"query","required":false,"schema":{"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"},"style":"form"},"0e3cefdb-fa29-4c5f-aafa-5a0a74d95840":{"name":"created_at_gte","in":"query","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"},"style":"form"},"f715d445-66c8-4f47-b229-e6bf14b4cf64":{"name":"created_at_lte","in":"query","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"},"style":"form"},"051405fe-c887-4ae6-99e9-f937dd1d77f9":{"name":"due_at_gte","in":"query","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"},"style":"form"},"bba1b654-6268-4fa1-a2f2-2e68c3cc6a8c":{"name":"due_at_lte","in":"query","required":false,"schema":{"type":"string","format":"date-time","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time>"},"style":"form"},"aea7f220-2937-4b92-860f-627400b5ab81":{"name":"total_amount_gte","in":"query","required":false,"schema":{"type":"integer","format":"int64","isRequired":false,"uniqueKey":"","typeLabel":"integer\u003cint64>"},"style":"form"},"da89dbf8-5725-4aef-8174-71d9d509a4a7":{"name":"total_amount_lte","in":"query","required":false,"schema":{"type":"integer","format":"int64","isRequired":false,"uniqueKey":"","typeLabel":"integer\u003cint64>"},"style":"form"},"cb791cdb-4c4f-401e-980e-1003590b47b3":{"name":"collection_method","in":"query","required":false,"schema":{"type":"string","enum":["auto_charge","manual"],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"style":"form"},"dab8b0fd-d3a0-42cc-85f4-e9284e41b32a":{"name":"page_size","in":"query","description":"Page size. The default is 10 and the maximum is 100.","required":false,"schema":{"type":"integer","format":"int32","minimum":0,"isRequired":false,"description":"Page size. The default is 10 and the maximum is 100.","uniqueKey":"","typeLabel":"integer\u003cint32>"},"style":"form"},"1ce12c6c-53cd-49e3-ae0b-902d2918c4d7":{"name":"page_number","in":"query","description":"Page number. The default is 0.","required":false,"schema":{"type":"integer","format":"int32","minimum":0,"isRequired":false,"description":"Page number. The default is 0.","uniqueKey":"","typeLabel":"integer\u003cint32>"},"style":"form"}},"responses":{"c6bd0b53-2118-4c38-853b-ba2f6aa8ae3c":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","description":"An invoice-led invoice. Every read and every `invoice.*` webhook uses this schema.","required":["invoice_id","business_id","status","billing_mode","currency","customer","created_at","metadata","row_version","tax","credits","total_amount","discount_ids","amount_paid","amount_refunded","amount_due","tags","retry_count","editable_fields","allowed_actions","subscription_ids","refund_ids","frequency"],"properties":{"allowed_actions":{"type":"array","items":{"type":"string","description":"An action that a merchant can request on the invoice in its current status.","enum":["edit","finalize","delete","send","retry","void","mark_uncollectable","change_dunning","add_note","duplicate"],"uniqueKey":"\\items.items.[INDEX].allowed_actions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"The actions that the current status accepts.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].allowed_actions","typeLabel":"enum\u003cstring>[]"},"amount_due":{"type":"integer","format":"int64","description":"The amount that the customer must pay. Zero unless the invoice is open or past due.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].amount_due","typeLabel":"integer\u003cint64>"},"amount_paid":{"type":"integer","format":"int64","description":"The sum of the succeeded payments, in the smallest currency unit. A late payment is not included after its late refund.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].amount_paid","typeLabel":"integer\u003cint64>"},"amount_refunded":{"type":"integer","format":"int64","description":"The sum of the succeeded refunds, in the currency of each payment. The late refund of a late payment is not included.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].amount_refunded","typeLabel":"integer\u003cint64>"},"billing_mode":{"type":"string","enum":["normal","invoice_led"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].billing_mode","typeLabel":"enum\u003cstring>"},"business_id":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].business_id","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"\\items.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"credits":{"type":"integer","format":"int64","description":"Customer credits applied at finalise, in the smallest currency unit. Zero or less.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].credits","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","enum":["AED","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BRL","BSD","BWP","BYN","BZD","CAD","CHF","CLP","CNY","COP","CRC","CUP","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","IQD","JMD","JOD","JPY","KES","KGS","KHR","KMF","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SEK","SGD","SHP","SLE","SLL","SOS","SRD","SSP","STN","SVC","SZL","THB","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","UYU","UZS","VES","VND","VUV","WST","XAF","XCD","XOF","XPF","YER","ZAR","ZMW"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"customer":{"type":"object","required":["customer_id","cc_emails","billing_address"],"properties":{"billing_address":{"type":"object","description":"A draft can have no country yet. Finalise needs it.","properties":{"city":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].customer.billing_address.city.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].customer.billing_address.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].customer.billing_address.city","typeLabel":"string | null"},"country":{"oneOf":[{"type":"null","uniqueKey":"\\items.items.[INDEX].customer.billing_address.country.oneOf.0","typeLabel":"null"},{"type":"string","description":"ISO country code alpha2 variant","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CG","CD","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW"],"uniqueKey":"\\items.items.[INDEX].customer.billing_address.country.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"\\items.items.[INDEX].customer.billing_address.country","typeLabel":"null | enum\u003cstring>"},"state":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].customer.billing_address.state.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].customer.billing_address.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].customer.billing_address.state","typeLabel":"string | null"},"street":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].customer.billing_address.street.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].customer.billing_address.street.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].customer.billing_address.street","typeLabel":"string | null"},"zipcode":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].customer.billing_address.zipcode.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].customer.billing_address.zipcode.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].customer.billing_address.zipcode","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].customer.billing_address","typeLabel":"object"},"cc_emails":{"type":"array","items":{"type":"string","uniqueKey":"\\items.items.[INDEX].customer.cc_emails.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].customer.cc_emails","typeLabel":"string[]"},"customer_id":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].customer.customer_id","typeLabel":"string"},"email":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].customer.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].customer.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].customer.email","typeLabel":"string | null"},"tax_id":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].customer.tax_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].customer.tax_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].customer.tax_id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].customer","typeLabel":"object"},"discount_ids":{"type":"array","items":{"type":"string","uniqueKey":"\\items.items.[INDEX].discount_ids.items.[INDEX]","typeLabel":"string"},"description":"The discount codes of the invoice.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].discount_ids","typeLabel":"string[]"},"editable_fields":{"type":"array","items":{"type":"string","enum":["customer","items","discounts","currency","billing_address","tax_id","review_required","due_at","collection_method","memo","customer_email","cc_emails","dunning","metadata"],"uniqueKey":"\\items.items.[INDEX].editable_fields.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"The fields that `PATCH` can change in the current status.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].editable_fields","typeLabel":"enum\u003cstring>[]"},"frequency":{"oneOf":[{"type":"object","title":"One Time","description":"How often the invoice lines bill. `mixed` covers several intervals, or one-time lines next to a plan.","required":["type"],"properties":{"type":{"type":"string","enum":["one_time"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency.oneOf.0","typeLabel":"One Time · object"},{"type":"object","title":"Recurring","description":"How often the invoice lines bill. `mixed` covers several intervals, or one-time lines next to a plan.","required":["count","interval","type"],"properties":{"count":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency.oneOf.1.count","typeLabel":"integer\u003cint32>"},"interval":{"type":"string","description":"Unit of a duration count (e.g. license-key validity period).","enum":["Day","Week","Month","Year"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency.oneOf.1.interval","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["recurring"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency.oneOf.1","typeLabel":"Recurring · object"},{"type":"object","title":"Mixed","description":"How often the invoice lines bill. `mixed` covers several intervals, or one-time lines next to a plan.","required":["type"],"properties":{"type":{"type":"string","enum":["mixed"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency.oneOf.2.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency.oneOf.2","typeLabel":"Mixed · object"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].frequency","typeLabel":"One Time · object | Recurring · object | Mixed · object"},"invoice_id":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].invoice_id","typeLabel":"string"},"metadata":{"type":"object","isRequired":true,"uniqueKey":"\\items.items.[INDEX].metadata","typeLabel":"object"},"refund_ids":{"type":"array","items":{"type":"string","uniqueKey":"\\items.items.[INDEX].refund_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].refund_ids","typeLabel":"string[]"},"retry_count":{"type":"integer","format":"int32","description":"The number of failed automatic charges.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].retry_count","typeLabel":"integer\u003cint32>"},"row_version":{"type":"integer","format":"int64","description":"Goes up by one on each change. Use it to ignore an older webhook delivery.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].row_version","typeLabel":"integer\u003cint64>"},"status":{"type":"string","description":"The `message` of each variant is the label of the invoice document.","enum":["open","paid","void","draft","past_due","uncollectable"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"subscription_ids":{"type":"array","items":{"type":"string","uniqueKey":"\\items.items.[INDEX].subscription_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].subscription_ids","typeLabel":"string[]"},"tags":{"type":"array","items":{"type":"string","enum":["refunded","partially_refunded","disputed","payment_reversed"],"uniqueKey":"\\items.items.[INDEX].tags.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].tags","typeLabel":"enum\u003cstring>[]"},"tax":{"type":"integer","format":"int32","description":"Tax in the smallest currency unit.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].tax","typeLabel":"integer\u003cint32>"},"total_amount":{"type":"integer","format":"int32","description":"Total with tax, before credits, in the smallest currency unit.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].total_amount","typeLabel":"integer\u003cint32>"},"collection_method":{"oneOf":[{"type":"null","uniqueKey":"\\items.items.[INDEX].collection_method.oneOf.0","typeLabel":"null"},{"type":"string","enum":["auto_charge","manual"],"uniqueKey":"\\items.items.[INDEX].collection_method.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"\\items.items.[INDEX].collection_method","typeLabel":"null | enum\u003cstring>"},"due_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"\\items.items.[INDEX].due_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"\\items.items.[INDEX].due_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].due_at","typeLabel":"string\u003cdate-time> | null"},"dunning_state":{"oneOf":[{"type":"null","uniqueKey":"\\items.items.[INDEX].dunning_state.oneOf.0","typeLabel":"null"},{"type":"string","description":"`null` for an invoice that has no collection: draft, paid, void or uncollectable.","enum":["not_started","active","paused","exhausted"],"uniqueKey":"\\items.items.[INDEX].dunning_state.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"\\items.items.[INDEX].dunning_state","typeLabel":"null | enum\u003cstring>"},"finalized_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"\\items.items.[INDEX].finalized_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"\\items.items.[INDEX].finalized_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].finalized_at","typeLabel":"string\u003cdate-time> | null"},"hosted_url":{"oneOf":[{"type":"string","description":"The page where the customer pays. `null` until the invoice is sent.","uniqueKey":"\\items.items.[INDEX].hosted_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The page where the customer pays. `null` until the invoice is sent.","uniqueKey":"\\items.items.[INDEX].hosted_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].hosted_url","typeLabel":"string | null"},"lines":{"oneOf":[{"type":"array","items":{"type":"object","description":"One frozen line. Amounts are in the smallest currency unit.","required":["kind","quantity","unit_amount","tax","tax_inclusive","amount"],"properties":{"amount":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].amount","typeLabel":"integer\u003cint64>"},"kind":{"type":"string","enum":["subscription","addon","meter","credit_overage","one_time"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"quantity":{"type":"integer","format":"int32","description":"A usage line has a quantity of 1. Its amount is the full usage charge.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].quantity","typeLabel":"integer\u003cint32>"},"tax":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].tax","typeLabel":"integer\u003cint64>"},"tax_inclusive":{"type":"boolean","description":"`true` when `amount` includes `tax`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].tax_inclusive","typeLabel":"boolean"},"unit_amount":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].unit_amount","typeLabel":"integer\u003cint64>"},"addon_id":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].addon_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].addon_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].addon_id","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].description","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].name","typeLabel":"string | null"},"period_end":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].period_end.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].period_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].period_end","typeLabel":"string\u003cdate-time> | null"},"period_start":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].period_start.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].period_start.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].period_start","typeLabel":"string\u003cdate-time> | null"},"product_id":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].product_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].product_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].product_id","typeLabel":"string | null"},"subscription_id":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].subscription_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].subscription_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].subscription_id","typeLabel":"string | null"},"tax_rate":{"oneOf":[{"type":"integer","format":"int32","description":"Tax percent times 100. For example, 1800 is 18%.","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].tax_rate.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","description":"Tax percent times 100. For example, 1800 is 18%.","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].tax_rate.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX].tax_rate","typeLabel":"integer\u003cint32> | null"}},"uniqueKey":"\\items.items.[INDEX].lines.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Only on a single invoice. A list leaves it out.","uniqueKey":"\\items.items.[INDEX].lines.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","description":"One frozen line. Amounts are in the smallest currency unit.","required":["kind","quantity","unit_amount","tax","tax_inclusive","amount"],"properties":{"addon_id":{"oneOf":[{"type":"string"},{"type":"null"}]},"amount":{"type":"integer","format":"int64"},"description":{"oneOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["subscription","addon","meter","credit_overage","one_time"]},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"period_end":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]},"period_start":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]},"product_id":{"oneOf":[{"type":"string"},{"type":"null"}]},"quantity":{"type":"integer","format":"int32","description":"A usage line has a quantity of 1. Its amount is the full usage charge."},"subscription_id":{"oneOf":[{"type":"string"},{"type":"null"}]},"tax":{"type":"integer","format":"int64"},"tax_inclusive":{"type":"boolean","description":"`true` when `amount` includes `tax`."},"tax_rate":{"oneOf":[{"type":"integer","format":"int32","description":"Tax percent times 100. For example, 1800 is 18%."},{"type":"null","format":"int32","description":"Tax percent times 100. For example, 1800 is 18%."}]},"unit_amount":{"type":"integer","format":"int64"}}},"description":"Only on a single invoice. A list leaves it out.","uniqueKey":"\\items.items.[INDEX].lines.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].lines","typeLabel":"object[] | null"},"memo":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].memo.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].memo.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].memo","typeLabel":"string | null"},"next_reminder_at":{"oneOf":[{"type":"string","format":"date-time","description":"The time of the next reminder email to the customer, before or after the due date.\n`null` when no reminder email will go out.","uniqueKey":"\\items.items.[INDEX].next_reminder_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"The time of the next reminder email to the customer, before or after the due date.\n`null` when no reminder email will go out.","uniqueKey":"\\items.items.[INDEX].next_reminder_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].next_reminder_at","typeLabel":"string\u003cdate-time> | null"},"next_retry_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"\\items.items.[INDEX].next_retry_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"\\items.items.[INDEX].next_retry_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].next_retry_at","typeLabel":"string\u003cdate-time> | null"},"payment_terms_days":{"oneOf":[{"type":"integer","format":"int32","description":"Days from finalise to the due date. `null` when the invoice has a custom due date.","uniqueKey":"\\items.items.[INDEX].payment_terms_days.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","description":"Days from finalise to the due date. `null` when the invoice has a custom due date.","uniqueKey":"\\items.items.[INDEX].payment_terms_days.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].payment_terms_days","typeLabel":"integer\u003cint32> | null"},"payments":{"oneOf":[{"type":"array","items":{"type":"object","required":["payment_id","amount","created_at"],"properties":{"amount":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].amount","typeLabel":"integer\u003cint64>"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"payment_id":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].payment_id","typeLabel":"string"},"retry_attempt":{"oneOf":[{"type":"integer","format":"int32","description":"The automatic charge number. `null` for a payment that the customer started.","uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].retry_attempt.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","description":"The automatic charge number. `null` for a payment that the customer started.","uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].retry_attempt.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].retry_attempt","typeLabel":"integer\u003cint32> | null"},"status":{"oneOf":[{"type":"null","uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].status.oneOf.0","typeLabel":"null"},{"type":"string","description":"`null` while the processor has not answered.","enum":["succeeded","failed","cancelled","processing","requires_customer_action","requires_merchant_action","requires_payment_method","requires_confirmation","requires_capture","partially_captured","partially_captured_and_capturable"],"uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].status.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX].status","typeLabel":"null | enum\u003cstring>"}},"uniqueKey":"\\items.items.[INDEX].payments.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Only on a single invoice. A list leaves it out.","uniqueKey":"\\items.items.[INDEX].payments.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","required":["payment_id","amount","created_at"],"properties":{"amount":{"type":"integer","format":"int64"},"created_at":{"type":"string","format":"date-time"},"payment_id":{"type":"string"},"retry_attempt":{"oneOf":[{"type":"integer","format":"int32","description":"The automatic charge number. `null` for a payment that the customer started."},{"type":"null","format":"int32","description":"The automatic charge number. `null` for a payment that the customer started."}]},"status":{"oneOf":[{"type":"null"},{"type":"string","description":"`null` while the processor has not answered.","enum":["succeeded","failed","cancelled","processing","requires_customer_action","requires_merchant_action","requires_payment_method","requires_confirmation","requires_capture","partially_captured","partially_captured_and_capturable"]}]}}},"description":"Only on a single invoice. A list leaves it out.","uniqueKey":"\\items.items.[INDEX].payments.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].payments","typeLabel":"object[] | null"},"pdf_url":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].pdf_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].pdf_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].pdf_url","typeLabel":"string | null"},"reminder_settings":{"oneOf":[{"type":"null","uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.0","typeLabel":"null"},{"type":"object","title":"Snapshot","description":"`null` on a draft that keeps all reminder settings of the business.","required":["reminders_enabled","offsets_minutes","paused","kind"],"properties":{"kind":{"type":"string","enum":["snapshot"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"offsets_minutes":{"type":"array","items":{"type":"integer","format":"int64","uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.1.offsets_minutes.items.[INDEX]","typeLabel":"integer\u003cint64>"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.1.offsets_minutes","typeLabel":"integer\u003cint64>[]"},"paused":{"type":"boolean","isRequired":true,"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.1.paused","typeLabel":"boolean"},"reminders_enabled":{"type":"boolean","isRequired":true,"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.1.reminders_enabled","typeLabel":"boolean"}},"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.1","typeLabel":"Snapshot · object"},{"type":"object","title":"Override","description":"`null` on a draft that keeps all reminder settings of the business.","required":["kind"],"properties":{"kind":{"type":"string","enum":["override"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"offsets_minutes":{"oneOf":[{"type":"array","items":{"type":"integer","format":"int64","uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.offsets_minutes.oneOf.0.items.[INDEX]","typeLabel":"integer\u003cint64>"},"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.offsets_minutes.oneOf.0","typeLabel":"integer\u003cint64>[]"},{"type":"null","items":{"type":"integer","format":"int64"},"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.offsets_minutes.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.offsets_minutes","typeLabel":"integer\u003cint64>[] | null"},"paused":{"oneOf":[{"type":"boolean","uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.paused.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.paused.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.paused","typeLabel":"boolean | null"},"reminders_enabled":{"oneOf":[{"type":"boolean","uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.reminders_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.reminders_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2.reminders_enabled","typeLabel":"boolean | null"}},"uniqueKey":"\\items.items.[INDEX].reminder_settings.oneOf.2","typeLabel":"Override · object"}],"uniqueKey":"\\items.items.[INDEX].reminder_settings","typeLabel":"null | Snapshot · object | Override · object"},"review_deadline":{"oneOf":[{"type":"string","format":"date-time","description":"The time at which a draft that waits for review finalises.","uniqueKey":"\\items.items.[INDEX].review_deadline.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"The time at which a draft that waits for review finalises.","uniqueKey":"\\items.items.[INDEX].review_deadline.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].review_deadline","typeLabel":"string\u003cdate-time> | null"},"sent_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"\\items.items.[INDEX].sent_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"\\items.items.[INDEX].sent_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].sent_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"items":[{"allowed_actions":["edit"],"amount_due":123,"amount_paid":123,"amount_refunded":123,"billing_mode":"normal","business_id":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","credits":123,"currency":"AED","customer":{"billing_address":{"city":"\u003cstring>","country":"AF","state":"\u003cstring>","street":"\u003cstring>","zipcode":"\u003cstring>"},"cc_emails":["\u003cstring>"],"customer_id":"\u003cstring>","email":"\u003cstring>","tax_id":"\u003cstring>"},"discount_ids":["\u003cstring>"],"editable_fields":["customer"],"frequency":{"type":"one_time"},"invoice_id":"\u003cstring>","metadata":{},"refund_ids":["\u003cstring>"],"retry_count":123,"row_version":123,"status":"open","subscription_ids":["\u003cstring>"],"tags":["refunded"],"tax":123,"total_amount":123,"collection_method":"auto_charge","due_at":"2023-11-07T05:31:56Z","dunning_state":"not_started","finalized_at":"2023-11-07T05:31:56Z","hosted_url":"\u003cstring>","lines":[{"amount":123,"kind":"subscription","quantity":123,"tax":123,"tax_inclusive":true,"unit_amount":123,"addon_id":"\u003cstring>","description":"\u003cstring>","name":"\u003cstring>","period_end":"2023-11-07T05:31:56Z","period_start":"2023-11-07T05:31:56Z","product_id":"\u003cstring>","subscription_id":"\u003cstring>","tax_rate":123}],"memo":"\u003cstring>","next_reminder_at":"2023-11-07T05:31:56Z","next_retry_at":"2023-11-07T05:31:56Z","payment_terms_days":123,"payments":[{"amount":123,"created_at":"2023-11-07T05:31:56Z","payment_id":"\u003cstring>","retry_attempt":123,"status":"succeeded"}],"pdf_url":"\u003cstring>","reminder_settings":{"kind":"snapshot","offsets_minutes":[123],"paused":true,"reminders_enabled":true},"review_deadline":"2023-11-07T05:31:56Z","sent_at":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"459bda64-55f9-406e-a774-bd7cb66ed6eb":{"description":"A query parameter is not valid (InvalidQueryParams or InvalidRequestParameters).","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"c0a89b1b-30db-46f2-b14f-c521e2f2b018":{"description":"Something went wrong :(","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"9337a13b-b8f7-45ee-9f19-7c7217e4c607":{"API_KEY":{"type":"http","scheme":"bearer","description":"Send your API key as a bearer token: `Authorization: Bearer \u003capi_key>`. A test mode key starts with `dodo_test_`, for example `dodo_test_AbCd1234EfGh5678.\u003csecret>`. A live mode key starts with `dodo_live_`. Use a test mode key on `test.dodopayments.com` and a live mode key on `live.dodopayments.com`. Keys from before these tags have no tag and operate as before.","scopes":[],"schemeName":"API_KEY"}}},"servers":{"258c6c34-2f0b-4091-a5e0-d5c0da1d0e4f":{"url":"https://test.dodopayments.com/","description":"Test Mode Server Host"},"5001ffd6-aa75-47ac-b009-c76c158d0a43":{"url":"https://live.dodopayments.com/","description":"Live Mode Server Host"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Send your API key as a bearer token: `Authorization: Bearer \u003capi_key>`. A test mode key starts with `dodo_test_`, for example `dodo_test_AbCd1234EfGh5678.\u003csecret>`. A live mode key starts with `dodo_live_`. Use a test mode key on `test.dodopayments.com` and a live mode key on `live.dodopayments.com`. Keys from before these tags have no tag and operate as before.","scopes":[],"schemeName":"API_KEY"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send your API key as a bearer token: `Authorization: Bearer \u003capi_key>`. A test mode key starts with `dodo_test_`, for example `dodo_test_AbCd1234EfGh5678.\u003csecret>`. A live mode key starts with `dodo_live_`. Use a test mode key on `test.dodopayments.com` and a live mode key on `live.dodopayments.com`. Keys from before these tags have no tag and operate as before.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"API_KEY","name":"Authorization"}],"title":"API_KEY"}]},"originalFileLocation":"openapi/openapi.documented.yml"},"subdomain":"dodopayments","siteName":"Dodo Payments Documentation","title":"List Invoices - Dodo Payments Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/invoices/list-invoices","matchLevel":0},"es":{"href":"/es/introduction","matchLevel":4},"ar":{"href":"/ar/introduction","matchLevel":4},"fr":{"href":"/fr/introduction","matchLevel":4},"de":{"href":"/de/introduction","matchLevel":4},"id":{"href":"/id/introduction","matchLevel":4},"ja":{"href":"/ja/introduction","matchLevel":4},"ko":{"href":"/ko/introduction","matchLevel":4},"pt-BR":{"href":"/pt-BR/introduction","matchLevel":4},"vi":{"href":"/vi/introduction","matchLevel":4},"cn":{"href":"/cn/introduction","matchLevel":4},"hi":{"href":"/hi/introduction","matchLevel":4},"it":{"href":"/it/introduction","matchLevel":4},"sv":{"href":"/sv/introduction","matchLevel":4}}},"lastModified":"2026-11-10T08:07:20.711Z","gitLastModified":"2026-11-10T08:06:53.000Z","originalFileLocation":"api-reference/invoices/list-invoices.mdx","locale":"en"},"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=\"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dodo Payments Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Invoices - Dodo Payments Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dodo Payments Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dodopayments.com/api-reference/invoices/list-invoices\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dodopayments.mintlify.site/_mintlify/api/og/v2?division=Invoices\u0026amp;title=List+Invoices\u0026amp;description=List+invoice-led+invoices%2C+newest+first%2C+filtered+by+status%2C+customer%2C+subscription%2C+dates%2C+amount+or+collection+method.\u0026amp;theme=fcc3a546490e883f7462a320\u0026amp;signature=1b363b698ea7401cb36c105a9b353bfe54f687800a561d3bed056e8ce5abea4b\">\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=\"List Invoices - Dodo Payments Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dodopayments.mintlify.site/_mintlify/api/og/v2?division=Invoices\u0026amp;title=List+Invoices\u0026amp;description=List+invoice-led+invoices%2C+newest+first%2C+filtered+by+status%2C+customer%2C+subscription%2C+dates%2C+amount+or+collection+method.\u0026amp;theme=fcc3a546490e883f7462a320\u0026amp;signature=1b363b698ea7401cb36c105a9b353bfe54f687800a561d3bed056e8ce5abea4b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dodo Payments Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#779812\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dodopayments.com/api-reference/invoices/list-invoices\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/invoices/list-invoices.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dodopayments.com/#organization\",\"name\":\"Dodo Payments Documentation\",\"url\":\"https://docs.dodopayments.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dodopayments/nM_mJfYkri-OpC5M/logo/light.svg?fit=max\u0026auto=format\u0026n=nM_mJfYkri-OpC5M\u0026q=85\u0026s=23f7a052f7ecb9d6570b7c95ee359a97\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dodopayments.com#website\",\"name\":\"Dodo Payments Documentation\",\"url\":\"https://docs.dodopayments.com\",\"publisher\":{\"@id\":\"https://docs.dodopayments.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dodopayments.com/api-reference/invoices/list-invoices#webpage\",\"url\":\"https://docs.dodopayments.com/api-reference/invoices/list-invoices\",\"name\":\"List Invoices\",\"description\":\"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.\",\"dateModified\":\"2026-11-10T08:06:53.000Z\",\"isPartOf\":{\"@id\":\"https://docs.dodopayments.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dodopayments.com/api-reference/invoices/list-invoices#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dodopayments.com/api-reference/invoices/list-invoices#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dodo Payments Documentation\",\"item\":\"https://docs.dodopayments.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Invoices\",\"item\":\"https://docs.dodopayments.com/api-reference/invoices/list-invoices\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dodopayments.com/api-reference/invoices/list-invoices#apireference\",\"headline\":\"List Invoices\",\"name\":\"List Invoices\",\"description\":\"List invoice-led invoices, newest first, filtered by status, customer, subscription, dates, amount or collection method.\",\"url\":\"https://docs.dodopayments.com/api-reference/invoices/list-invoices\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dodopayments.com/api-reference/invoices/list-invoices#webpage\"},\"dateModified\":\"2026-11-10T08:06:53.000Z\",\"keywords\":\"Dodo Payments, API reference, REST API, list invoices\",\"publisher\":{\"@id\":\"https://docs.dodopayments.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dodopayments.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dodo Payments Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Dodo Payments Documentation","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Docs","icon":"book","pages":[{"title":"Docs","href":"/introduction"}]},{"tab":"Guides","icon":"compass","pages":[{"title":"Guides","href":"/developer-resources/integration-guide"}]},{"tab":"API Reference","icon":"rectangle-code","groups":[{"group":"API Reference","pages":[{"title":"API Reference","sidebarTitle":"Introduction","icon":"book-open","href":"/api-reference/introduction"},{"title":"Error Codes","icon":"triangle-exclamation","href":"/api-reference/error-codes"},{"title":"Transaction Failures","icon":"circle-exclamation","href":"/api-reference/transaction-failures"},{"title":"Metadata Guide","icon":"tags","href":"/api-reference/metadata"}]},{"group":"Checkout Sessions","pages":[{"openapi":"post /checkouts","title":"Create Checkout Session","href":"/api-reference/checkout-sessions/create"},{"openapi":"post /checkouts/preview","title":"Preview Checkout Session","href":"/api-reference/checkout-sessions/preview"},{"openapi":"get /checkouts/{id}","title":"Get Checkout Session","href":"/api-reference/checkout-sessions/get-checkouts"}]},{"group":"Payments","pages":[{"openapi":"get /payments","title":"List Payments","href":"/api-reference/payments/get-payments"},{"openapi":"get /payments/{payment_id}","title":"Get Payment Detail","href":"/api-reference/payments/get-payments-1"},{"title":"Get Invoice","openapi":"get /invoices/payments/{payment_id}","href":"/api-reference/payments/get-invoice"},{"openapi":"get /payments/{payment_id}/line-items","title":"Retrieve Line Items","href":"/api-reference/payments/retrieve-line-items"},{"openapi":"get /payments/{payment_id}/retry","title":"Get Manual Retry State","href":"/api-reference/payments/retrieve-retry-state"},{"openapi":"post /payments/{payment_id}/retry","title":"Retry Payment","href":"/api-reference/payments/retry-payment"},{"openapi":"post /payments","title":"Create One-Time Payment","tag":"DEPRECATED","href":"/api-reference/payments/post-payments"}]},{"group":"Subscriptions","pages":[{"openapi":"get /subscriptions","title":"List Subscriptions","href":"/api-reference/subscriptions/get-subscriptions-1"},{"openapi":"get /subscriptions/{subscription_id}","title":"Get Subscription Detail","href":"/api-reference/subscriptions/get-subscriptions"},{"openapi":"post /subscriptions/{subscription_id}/change-plan","title":"Change Plan","href":"/api-reference/subscriptions/change-plan"},{"openapi":"post /subscriptions/{subscription_id}/change-plan/preview","title":"Preview Plan Change","href":"/api-reference/subscriptions/preview-change-plan"},{"openapi":"delete /subscriptions/{subscription_id}/change-plan/scheduled","title":"Cancel Scheduled Plan Change","href":"/api-reference/subscriptions/cancel-change-plan"},{"openapi":"patch /subscriptions/{subscription_id}","title":"Update Subscription","href":"/api-reference/subscriptions/patch-subscriptions"},{"openapi":"post /subscriptions/{subscription_id}/charge","title":"Create Charge (On-Demand)","href":"/api-reference/subscriptions/create-charge"},{"openapi":"get /subscriptions/{subscription_id}/usage-history","title":"Get Subscription Usage History","href":"/api-reference/subscriptions/get-usage-history"},{"openapi":"get /subscriptions/{subscription_id}/credit-usage","title":"Retrieve Credit Usage","href":"/api-reference/subscriptions/retrieve-credit-usage"},{"openapi":"post /subscriptions/{subscription_id}/update-payment-method","title":"Update Payment Method","href":"/api-reference/subscriptions/update-payment-method"},{"openapi":"post /subscriptions","title":"Create Subscription","tag":"DEPRECATED","href":"/api-reference/subscriptions/post-subscriptions"},{"openapi":"get /subscriptions/{subscription_id}/upcoming-invoice","title":"Get the Upcoming Invoice of a Subscription","description":"Price the next cycle invoice of an invoice-led subscription before it is issued.","href":"/api-reference/subscriptions/get-upcoming-invoice"}]},{"group":"Invoices","pages":[{"openapi":"get /billing/invoices","title":"List Invoices","href":"/api-reference/invoices/list-invoices"},{"openapi":"post /billing/invoices","title":"Create a Draft Invoice","description":"Create a draft invoice for a customer. A repeat with the same Idempotency-Key returns the first draft.","href":"/api-reference/invoices/create-invoice"},{"openapi":"post /billing/invoices/preview","title":"Preview an Invoice Request","href":"/api-reference/invoices/preview-invoice-request"},{"openapi":"get /billing/invoices/{invoice_id}","title":"Get an Invoice","href":"/api-reference/invoices/get-invoice"},{"openapi":"patch /billing/invoices/{invoice_id}","title":"Update an Invoice","href":"/api-reference/invoices/update-invoice"},{"openapi":"delete /billing/invoices/{invoice_id}","title":"Delete a Draft Invoice","href":"/api-reference/invoices/delete-invoice"},{"openapi":"post /billing/invoices/{invoice_id}/finalize","title":"Finalize an Invoice","href":"/api-reference/invoices/finalize-invoice"},{"openapi":"post /billing/invoices/{invoice_id}/send","title":"Send an Invoice","href":"/api-reference/invoices/send-invoice"},{"openapi":"post /billing/invoices/{invoice_id}/hosted-link","title":"Create the Hosted Link of an Invoice","href":"/api-reference/invoices/create-hosted-link"},{"openapi":"post /billing/invoices/{invoice_id}/retry","title":"Retry the Charge of an Invoice","href":"/api-reference/invoices/retry-invoice"},{"openapi":"post /billing/invoices/{invoice_id}/dunning","title":"Change the Dunning of an Invoice","href":"/api-reference/invoices/change-dunning"},{"openapi":"post /billing/invoices/{invoice_id}/void","title":"Void an Invoice","href":"/api-reference/invoices/void-invoice"},{"openapi":"post /billing/invoices/{invoice_id}/mark-uncollectable","title":"Mark an Invoice Uncollectable","href":"/api-reference/invoices/mark-uncollectable"},{"openapi":"post /billing/invoices/{invoice_id}/duplicate","title":"Duplicate an Invoice","href":"/api-reference/invoices/duplicate-invoice"},{"openapi":"post /billing/invoices/{invoice_id}/notes","title":"Add a Note to an Invoice","href":"/api-reference/invoices/add-note"},{"openapi":"get /billing/invoices/{invoice_id}/events","title":"List the Events of an Invoice","href":"/api-reference/invoices/list-invoice-events"},{"openapi":"get /billing/invoices/{invoice_id}/preview","title":"Preview a Draft Invoice","href":"/api-reference/invoices/preview-invoice"}]},{"group":"Discounts","pages":[{"openapi":"get /discounts","title":"List Discounts","href":"/api-reference/discounts/list-discounts"},{"openapi":"post /discounts","title":"Create Discount","href":"/api-reference/discounts/create-discount"},{"openapi":"get /discounts/{discount_id}","title":"Get Discount","href":"/api-reference/discounts/validate-discount"},{"openapi":"get /discounts/code/{code}","title":"Get Discount by Code","href":"/api-reference/discounts/get-discount-by-code"},{"openapi":"patch /discounts/{discount_id}","title":"Update Discount","href":"/api-reference/discounts/update-discount"},{"openapi":"delete /discounts/{discount_id}","title":"Delete Discount","href":"/api-reference/discounts/delete-discount"},{"openapi":"get /discounts/{discount_id}/customers","title":"List Discount Customers","href":"/api-reference/discounts/list-discount-customers"},{"openapi":"post /discounts/{discount_id}/customers","title":"Add Discount Customers","href":"/api-reference/discounts/add-discount-customers"},{"openapi":"delete /discounts/{discount_id}/customers/{customer_id}","title":"Remove Discount Customer","href":"/api-reference/discounts/remove-discount-customer"}]},{"group":"Licenses","pages":[{"title":"Create License Key","openapi":"post /license_keys","href":"/api-reference/licenses/create-license-key"},{"title":"Activate License","openapi":"post /licenses/activate","href":"/api-reference/licenses/activate-license"},{"title":"Deactivate License","openapi":"post /licenses/deactivate","href":"/api-reference/licenses/deactivate-license"},{"title":"Validate License","openapi":"post /licenses/validate","href":"/api-reference/licenses/validate-license"},{"title":"List License Keys","openapi":"get /license_keys","tag":"DEPRECATED","href":"/api-reference/licenses/list-license-keys"},{"title":"Get License Key","openapi":"get /license_keys/{id}","tag":"DEPRECATED","href":"/api-reference/licenses/get-license-key"},{"title":"Update License Key","openapi":"patch /license_keys/{id}","tag":"DEPRECATED","href":"/api-reference/licenses/update-license-key"},{"title":"List License Key Instances","openapi":"get /license_key_instances","href":"/api-reference/licenses/get-license-key-instances"},{"title":"Get License Key Instance","openapi":"get /license_key_instances/{id}","href":"/api-reference/licenses/get-license-key-instance"},{"title":"Update License Key Instance","openapi":"patch /license_key_instances/{id}","href":"/api-reference/licenses/update-license-key-instance"}]},{"group":"Entitlements","pages":[{"title":"List Entitlements","openapi":"get /entitlements","href":"/api-reference/entitlements/list-entitlements"},{"title":"Create Entitlement","openapi":"post /entitlements","href":"/api-reference/entitlements/create-entitlement"},{"title":"Get Entitlement","openapi":"get /entitlements/{id}","href":"/api-reference/entitlements/get-entitlement"},{"title":"Update Entitlement","openapi":"patch /entitlements/{id}","href":"/api-reference/entitlements/update-entitlement"},{"title":"Delete Entitlement","openapi":"delete /entitlements/{id}","href":"/api-reference/entitlements/delete-entitlement"},{"title":"Upload File","openapi":"post /entitlements/{id}/files","href":"/api-reference/entitlements/upload-file"},{"title":"Delete File","openapi":"delete /entitlements/{id}/files/{file_id}","href":"/api-reference/entitlements/delete-file"},{"title":"List Grants","openapi":"get /entitlements/{id}/grants","href":"/api-reference/entitlements/list-grants"},{"title":"List Customer Grants","openapi":"get /customers/{customer_id}/entitlement-grants","href":"/api-reference/entitlements/list-customer-grants"},{"title":"Fulfill License Key Grant","openapi":"post /grants/{grant_id}/license-key","href":"/api-reference/entitlements/fulfill-license-key"},{"title":"Revoke Grant","openapi":"delete /entitlements/{id}/grants/{grant_id}","href":"/api-reference/entitlements/revoke-grant"}]},{"group":"Customers","pages":[{"openapi":"post /customers","title":"Create Customer","href":"/api-reference/customers/create-customer"},{"openapi":"get /customers","title":"List Customers","href":"/api-reference/customers/get-customers"},{"openapi":"get /customers/{customer_id}","title":"Get Customer Detail","href":"/api-reference/customers/get-customers-1"},{"openapi":"patch /customers/{customer_id}","title":"Update Customer","href":"/api-reference/customers/patch-customer"},{"openapi":"post /customers/{customer_id}/customer-portal/session","title":"Create Customer Portal Session","href":"/api-reference/customers/create-customer-portal-session"},{"openapi":"get /customers/{customer_id}/payment-methods","title":"List Payment Methods","href":"/api-reference/customers/get-customer-payment-methods"},{"openapi":"delete /customers/{customer_id}/payment-methods/{payment_method_id}","title":"Delete Payment Method","href":"/api-reference/customers/delete-payment-method"},{"openapi":"get /customers/{customer_id}/entitlements","title":"List Customer Entitlements","href":"/api-reference/customers/list-customer-entitlements"},{"openapi":"get /customers/{customer_id}/credit-entitlements","title":"List Customer Credit Entitlements","href":"/api-reference/customers/list-customer-credit-entitlements"},{"openapi":"get /customers/{customer_id}/emails","title":"List Customer Emails","href":"/api-reference/customers/list-customer-emails"},{"openapi":"get /customers/{customer_id}/emails/{email_log_id}/body","title":"Get Customer Email Content","href":"/api-reference/customers/get-customer-email-body"}]},{"group":"Customer Wallets","pages":[{"openapi":"get /customers/{customer_id}/wallets","title":"List Customer Wallets","href":"/api-reference/customers/get-customer-wallets"},{"openapi":"get /customers/{customer_id}/wallets/ledger-entries","title":"List Customer Wallet Ledger Entries","href":"/api-reference/customers/get-customer-wallets-ledger-entries"},{"openapi":"post /customers/{customer_id}/wallets/ledger-entries","title":"Create Customer Wallet Ledger Entry","href":"/api-reference/customers/post-customer-wallets-ledger-entries"}]},{"group":"Customer Blocklist","pages":[{"openapi":"get /blocklist/customers","title":"List Blocked Customers","href":"/api-reference/blocklist/list-blocked-customers"},{"openapi":"post /blocklist/customers","title":"Block Customer","href":"/api-reference/blocklist/block-customer"},{"openapi":"get /blocklist/customers/{entry_id}","title":"Get Blocked Customer","href":"/api-reference/blocklist/get-blocked-customer"},{"openapi":"delete /blocklist/customers/{entry_id}","title":"Unblock Customer","href":"/api-reference/blocklist/unblock-customer"},{"openapi":"post /blocklist/customers/{entry_id}/notes","title":"Add Blocklist Note","href":"/api-reference/blocklist/add-blocklist-note"},{"openapi":"patch /blocklist/customers/{entry_id}/notes/{note_id}","title":"Update Blocklist Note","href":"/api-reference/blocklist/update-blocklist-note"}]},{"group":"Products","pages":[{"openapi":"get /products","title":"List Products","href":"/api-reference/products/get-products"},{"openapi":"post /products","title":"Create Product","href":"/api-reference/products/post-products"},{"openapi":"get /products/{id}","title":"Get Product Detail","href":"/api-reference/products/get-products-1"},{"openapi":"patch /products/{id}","title":"Update Product","href":"/api-reference/products/patch-products"},{"openapi":"put /products/{id}/images","title":"Update Product Image","href":"/api-reference/products/put-products-images"},{"openapi":"delete /products/{id}","title":"Archive Product","href":"/api-reference/products/archive-product"},{"openapi":"post /products/{id}/unarchive","title":"Unarchive Product","href":"/api-reference/products/unarchive-product"},{"openapi":"put /products/{id}/files","title":"Upload Product File","href":"/api-reference/products/update-files"},{"openapi":"get /products/short_links","title":"List Short Links","href":"/api-reference/products/get-products-short-links"},{"openapi":"post /products/{id}/short_links","title":"Create Short Link","href":"/api-reference/products/post-products-id-short-links"}]},{"group":"Localized Pricing","pages":[{"openapi":"get /products/{product_id}/localized-prices","title":"List Localized Prices","href":"/api-reference/products/get-products-localized-prices"},{"openapi":"post /products/{product_id}/localized-prices","title":"Create Localized Price","href":"/api-reference/products/post-products-localized-prices"},{"openapi":"get /products/{product_id}/localized-prices/{id}","title":"Get Localized Price","href":"/api-reference/products/get-products-localized-prices-id"},{"openapi":"patch /products/{product_id}/localized-prices/{id}","title":"Update Localized Price","href":"/api-reference/products/patch-products-localized-prices"},{"openapi":"delete /products/{product_id}/localized-prices/{id}","title":"Archive Localized Price","href":"/api-reference/products/delete-products-localized-prices"}]},{"group":"Addons","pages":[{"openapi":"post /addons","title":"Create Addon","href":"/api-reference/addons/create-addon"},{"openapi":"get /addons","title":"List Addons","href":"/api-reference/addons/list-addons"},{"openapi":"get /addons/{id}","title":"Get Addon","href":"/api-reference/addons/get-addon"},{"openapi":"patch /addons/{id}","title":"Update Addon","href":"/api-reference/addons/update-addon"},{"openapi":"put /addons/{id}/images","title":"Update Addon Image","href":"/api-reference/addons/update-addon-images"},{"openapi":"delete /addons/{id}","title":"Archive Addon","href":"/api-reference/addons/archive-addon"},{"openapi":"post /addons/{id}/unarchive","title":"Unarchive Addon","href":"/api-reference/addons/unarchive-addon"}]},{"group":"Credit Entitlements","pages":[{"openapi":"get /credit-entitlements","title":"List Credit Entitlements","href":"/api-reference/credit-entitlements/list-credit-entitlements"},{"openapi":"post /credit-entitlements","title":"Create Credit Entitlement","href":"/api-reference/credit-entitlements/create-credit-entitlement"},{"openapi":"get /credit-entitlements/{id}","title":"Get Credit Entitlement","href":"/api-reference/credit-entitlements/get-credit-entitlement"},{"openapi":"patch /credit-entitlements/{id}","title":"Update Credit Entitlement","href":"/api-reference/credit-entitlements/update-credit-entitlement"},{"openapi":"delete /credit-entitlements/{id}","title":"Delete Credit Entitlement","href":"/api-reference/credit-entitlements/delete-credit-entitlement"},{"openapi":"post /credit-entitlements/{id}/undelete","title":"Undelete Credit Entitlement","href":"/api-reference/credit-entitlements/undelete-credit-entitlement"},{"openapi":"get /credit-entitlements/{credit_entitlement_id}/balances","title":"List Balances","href":"/api-reference/credit-entitlements/list-balances"},{"openapi":"get /credit-entitlements/{credit_entitlement_id}/balances/{customer_id}","title":"Get Customer Balance","href":"/api-reference/credit-entitlements/get-customer-balance"},{"openapi":"get /credit-entitlements/{credit_entitlement_id}/balances/{customer_id}/grants","title":"List Customer Grants","href":"/api-reference/credit-entitlements/list-customer-grants"},{"openapi":"get /credit-entitlements/{credit_entitlement_id}/balances/{customer_id}/ledger","title":"List Customer Ledger","href":"/api-reference/credit-entitlements/list-customer-ledger"},{"openapi":"post /credit-entitlements/{credit_entitlement_id}/balances/{customer_id}/ledger-entries","title":"Create Ledger Entry","href":"/api-reference/credit-entitlements/create-ledger-entry"}]},{"group":"Meters","pages":[{"openapi":"post /meters","title":"Create Meter","href":"/api-reference/meters/create-meter"},{"openapi":"get /meters","title":"List Meters","href":"/api-reference/meters/get-meters"},{"openapi":"get /meters/{id}","title":"Get Meter","href":"/api-reference/meters/retrieve-meter"},{"openapi":"patch /meters/{id}","title":"Update Meter","href":"/api-reference/meters/update-meter"},{"openapi":"delete /meters/{id}","title":"Archive Meter","href":"/api-reference/meters/archive-meter"},{"openapi":"post /meters/{id}/unarchive","title":"Unarchive Meter","href":"/api-reference/meters/unarchive-meter"}]},{"group":"Usage Events","pages":[{"openapi":"post /events/ingest","title":"Ingest Events","href":"/api-reference/usage-events/ingest-events"},{"openapi":"get /events/{event_id}","title":"Get Event","href":"/api-reference/usage-events/get-event"},{"openapi":"get /events","title":"List Events","href":"/api-reference/usage-events/list-events"}]},{"group":"Refunds","pages":[{"openapi":"get /refunds","title":"List Refunds","href":"/api-reference/refunds/get-refunds"},{"openapi":"post /refunds","title":"Create Refund","href":"/api-reference/refunds/post-refunds"},{"openapi":"get /refunds/{refund_id}","title":"Get Refund Detail","href":"/api-reference/refunds/get-refunds-1"},{"openapi":"get /invoices/refunds/{refund_id}","title":"Get Refund Receipt","href":"/api-reference/refunds/get-refund-receipt"}]},{"group":"Disputes","pages":[{"openapi":"get /disputes","title":"List Disputes","href":"/api-reference/disputes/get-disputes"},{"openapi":"get /disputes/{dispute_id}","title":"Get Dispute Detail","href":"/api-reference/disputes/get-disputes-1"}]},{"group":"Payouts","pages":[{"openapi":"get /payouts","title":"List Payouts","href":"/api-reference/payouts/get-payouts"},{"openapi":"get /payouts/{payout_id}/breakup","title":"Retrieve Payout Breakup","href":"/api-reference/payouts/retrieve-breakup"},{"openapi":"get /payouts/{payout_id}/breakup/details","title":"List Payout Breakup Details","href":"/api-reference/payouts/list-breakup-details"},{"openapi":"get /payouts/{payout_id}/breakup/details/csv","title":"Download Payout Breakup CSV","href":"/api-reference/payouts/download-breakup-csv"},{"openapi":"get /invoices/payouts/{payout_id}","title":"Get Payout Invoice","href":"/api-reference/payouts/get-payout-invoice"}]},{"group":"Balance Ledger","pages":[{"openapi":"get /balances/ledger","title":"List Balance Ledger Entries","href":"/api-reference/balance-ledger/list-ledger-entries"}]},{"group":"Moderation","tag":"NEW","pages":[{"openapi":"post /moderation/screen","title":"Screen a Prompt","href":"/api-reference/moderation/screen"},{"openapi":"get /moderation/usage","title":"Get Moderation Usage","href":"/api-reference/moderation/get-usage"}]},{"group":"Brands","pages":[{"openapi":"get /brands","title":"List Brands","href":"/api-reference/brands/list-brands"},{"openapi":"post /brands","title":"Create Brand","href":"/api-reference/brands/create-brand"},{"openapi":"get /brands/{id}","title":"Get Brand","href":"/api-reference/brands/get-brand"},{"openapi":"patch /brands/{id}","title":"Update Brand","href":"/api-reference/brands/update-brand"},{"openapi":"put /brands/{id}/images","title":"Update Brand Image","href":"/api-reference/brands/update-brand-images"},{"openapi":"post /brands/{id}/archive","title":"Archive Brand","href":"/api-reference/brands/archive-brand"}]},{"group":"Webhooks","pages":[{"openapi":"get /webhooks","title":"List Webhooks","href":"/api-reference/webhooks/list-webhooks"},{"openapi":"post /webhooks","title":"Create Webhook","href":"/api-reference/webhooks/create-webhook"},{"openapi":"get /webhooks/{webhook_id}","title":"Get Webhook Detail","href":"/api-reference/webhooks/get-details"},{"openapi":"patch /webhooks/{webhook_id}","title":"Update Webhook","href":"/api-reference/webhooks/update-webhook"},{"openapi":"delete /webhooks/{webhook_id}","title":"Delete Webhook","href":"/api-reference/webhooks/delete-webhook"},{"openapi":"get /webhooks/{webhook_id}/headers","title":"Get Webhook Headers","href":"/api-reference/webhooks/get-webhook-headers"},{"openapi":"patch /webhooks/{webhook_id}/headers","title":"Update Webhook Headers","href":"/api-reference/webhooks/update-webhook-headers"},{"openapi":"get /webhooks/{webhook_id}/secret","title":"Get Webhook Signing Key","href":"/api-reference/webhooks/get-webhook-signing-key"}]},{"group":"Miscellaneous","pages":[{"title":"Supported Countries","openapi":"get /checkout/supported_countries","href":"/api-reference/misc/supported-countries"}]},{"group":"Product Collections","pages":[{"openapi":"get /product-collections","title":"List Product Collections","href":"/api-reference/product-collections/list-product-collections"},{"openapi":"post /product-collections","title":"Create Product Collection","href":"/api-reference/product-collections/create-product-collection"},{"openapi":"get /product-collections/{id}","title":"Get Product Collection","href":"/api-reference/product-collections/get-product-collection"},{"openapi":"patch /product-collections/{id}","title":"Update Product Collection","href":"/api-reference/product-collections/update-product-collection"},{"openapi":"delete /product-collections/{id}","title":"Archive Product Collection","href":"/api-reference/product-collections/archive-product-collection"},{"openapi":"post /product-collections/{id}/unarchive","title":"Unarchive Product Collection","href":"/api-reference/product-collections/unarchive-product-collection"},{"openapi":"put /product-collections/{id}/images","title":"Update Product Collection Image","href":"/api-reference/product-collections/update-product-collection-images"},{"openapi":"post /product-collections/{id}/groups","title":"Create Product Collection Group","href":"/api-reference/product-collections/create-group"},{"openapi":"patch /product-collections/{id}/groups/{group_id}","title":"Update Product Collection Group","href":"/api-reference/product-collections/update-group"},{"openapi":"delete /product-collections/{id}/groups/{group_id}","title":"Delete Product Collection Group","href":"/api-reference/product-collections/delete-group"},{"openapi":"post /product-collections/{id}/groups/{group_id}/items","title":"Add Products to Group","href":"/api-reference/product-collections/add-group-items"},{"openapi":"patch /product-collections/{id}/groups/{group_id}/items/{item_id}","title":"Update Group Item","href":"/api-reference/product-collections/update-group-item"},{"openapi":"delete /product-collections/{id}/groups/{group_id}/items/{item_id}","title":"Delete Group Item","href":"/api-reference/product-collections/delete-group-item"}]}]},{"tab":"External Integrations","icon":"plug","pages":[{"title":"External Integrations","href":"/integrations/introduction"}]},{"tab":"Changelog","icon":"calendar-days","pages":[{"title":"Changelog","href":"/changelog/introduction"}]},{"tab":"Community Projects","icon":"users","pages":[{"title":"Community Projects","href":"/community/overview"}]}]},{"language":"es","pages":[{"title":"es","href":"/es/introduction"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/introduction"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/introduction"}]},{"language":"de","pages":[{"title":"de","href":"/de/introduction"}]},{"language":"id","pages":[{"title":"id","href":"/id/introduction"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/introduction"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/introduction"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/introduction"}]},{"language":"vi","pages":[{"title":"vi","href":"/vi/introduction"}]},{"language":"cn","pages":[{"title":"cn","href":"/cn/introduction"}]},{"language":"hi","pages":[{"title":"hi","href":"/hi/introduction"}]},{"language":"it","pages":[{"title":"it","href":"/it/introduction"}]},{"language":"sv","pages":[{"title":"sv","href":"/sv/introduction"}]}]},"basePath":"","title":"List Invoices - Dodo Payments Documentation","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","b0f84f53ff","2b790eda92","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C945cI-W.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}