Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
id
string
required
Example:
"inv_drjjua6ampd1op2fg98k89x8"
Response
Retrieve the invoice details
Usage invoice
Prepayment invoice
Void invoice
object
enum<string>
required
Available options:
invoice
id
string
required
Unique identifier of the invoice.
Example:
"inv_drjjua6ampd1op2fg98k89x8"
customer
string
required
ID of the customer the invoice belongs to.
Example:
"cus_a8n8ol7yd4h0wohx824f0bui"
subscription
string
required
ID of the subscription the invoice belongs to.
Example:
"sub_jd8mlscm062jb6ks50tck9gi"
invoice_number
string
required
Human-readable invoice number displayed on the invoice document
Example:
"H62SU12A-003"
month
number
required
Numeric month (1-12) for which the invoice is issued
Example:
4
year
number
required
Four-digit year for which the invoice is issued
Example:
2025
period_start
string
required
Timestamp marking the beginning of the billing period (inclusive)
Example:
"2025-03-31T22:00:00Z"
period_end
string
required
Timestamp marking the end of the billing period (exclusive)
Example:
"2025-04-30T22:00:00Z"
period_number
number
required
Sequential number of the billing period within the subscription (1-based)
Example:
3
status
enum<string>
required
Current status of the invoice:
Available options:
open,
paid,
voided
Example:
"open"
type
enum<string>
required
Discriminator for usage invoices, which bill metered electricity consumption for the period.
Available options:
usage
Example:
"usage"
usage
number
required
Total energy consumption in kilowatt-hours (kWh) during the billing period
Example:
100
total
number
required
Total amount due in euros (EUR) including all fees, taxes, and energy costs
Example:
110.04
issued_at
stringstring<date-time>any
Timestamp when the invoice was issued
Example:
"2024-03-14T12:00:00Z"
paid_at
stringstring<date-time>any
Timestamp when the invoice was paid
Example:
"2024-03-14T12:00:00Z"
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Nomos","colors":{"primary":"#1b1915","light":"#ffffff","dark":"#1b1915"},"logo":{"light":"https://mintcdn.com/riverslate/0nQqndf6SGR4MtUC/logo/light.svg?fit=max\u0026auto=format\u0026n=0nQqndf6SGR4MtUC\u0026q=85\u0026s=99c5d32286bf07989f99539ad1584d34","dark":"https://mintcdn.com/riverslate/0nQqndf6SGR4MtUC/logo/dark.svg?fit=max\u0026auto=format\u0026n=0nQqndf6SGR4MtUC\u0026q=85\u0026s=1e24faf333cc5cbbaa6454764020bc7d"},"favicon":"https://mintcdn.com/riverslate/i0UKnKz5dNnV7CMC/favicon.ico?fit=max\u0026auto=format\u0026n=i0UKnKz5dNnV7CMC\u0026q=85\u0026s=019f4931cf3d704bd7a11ab89eec374e","api":{"openapi":["openapi/openapi.chucky.json"]},"appearance":{"default":"light"},"background":{"color":{"light":"#f6f3f0","dark":"#21262c"}},"navbar":{"links":[{"href":"https://dashboard.nomos.energy","label":"Dashboard"}],"primary":{"type":"button","label":"Book Demo","href":"https://nomos.energy/demo"}},"footer":{"socials":{"website":"https://nomos.energy","linkedin":"https://www.linkedin.com/company/nomos-energy"}},"fonts":{"family":"Soehne","source":"https://qnsvr1iaztsgci9a.public.blob.vercel-storage.com/soehne-buch-d177Pah3KmnkO2UpYz4Ru0Yx4QcPU8.woff2","format":"woff2"},"contextual":{"options":["copy","view","claude","chatgpt","cursor",{"title":"Get Support","description":"Email our team about this page","icon":"life-ring","href":{"base":"mailto:support@nomos.energy","query":[{"key":"subject","value":"Docs question"},{"key":"body","value":"Page: $path\n\n"}]}}],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"riverslate","hasAudioNarration":false,"actualSubdomain":"riverslate","customDomains":["docs.nomos.energy"],"gitSource":{"type":"github","owner":"nomos-energy","repo":"monorepo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afd9e595f051bf67519ae7f","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":411},{"language":"default","tag":"Subscriptions","count":29},{"language":"default","tag":"Webhooks","count":23},{"language":"default","tag":"Invoices","count":23},{"language":"default","tag":"Usage","count":22},{"language":"default","tag":"Leads","count":20},{"language":"default","tag":"Plans","count":20},{"language":"default","tag":"Authentication","count":18},{"language":"default","tag":"Documentation","count":16},{"language":"default","tag":"Assets","count":16}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".light .navbar-link a,.light #search-bar-entry,.light #assistant-entry,.light button[aria-label=\"Toggle dark mode\"]{background-color:#ebe8e3!important}.light .navbar-link a:hover,.light #search-bar-entry:hover,.light #assistant-entry:hover,.light button[aria-label=\"Toggle dark mode\"]:hover{background-color:#e2ded9!important}.light #navbar>div.bg-background-light{background-color:#fdfbfa}.dark #navbar>div.bg-background-light{background-color:#000000}.dark #background-color{background-color:#0a0a0a}.light #pagination>a{background-color:#fdfbfa}.dark #pagination>a{background-color:#21262c}.light #page-context-menu button,.light [role=\"menu\"][aria-labelledby^=\"page-context-menu\"]{background-color:#fdfbfa}.dark #page-context-menu button,.dark [role=\"menu\"][aria-labelledby^=\"page-context-menu\"]{background-color:#21262c}#page-context-menu-button span{display:none}#page-context-menu{min-width:0;align-items:stretch}body:has(.is-home-page) #page-context-menu{display:none!important}body:has(.is-home-page) #pagination{display:none!important}.light details.expandable{background-color:#fdfbfa}.light div.bg-background-light:has(>div>.tryit-button){background-color:#fdfbfa}.light [data-component-part=\"version-select-content\"]{background-color:#fdfbfa}.light details.accordion{background-color:#fdfbfa}td code,th code{white-space:nowrap}.light .card{background-color:#fdfbfa}@font-face{font-family:\"Soehne\";src:url(\"/fonts/soehne-kraftig.woff2\") format(\"woff2\");font-weight:500 700;font-style:normal;font-display:swap}#navbar img[src*=\"logo\"],#navbar img[alt=\"light logo\"],#navbar img[alt=\"dark logo\"]{height:1.25rem;width:auto}h1,h2,h3,h4{font-weight:500!important}#navbar nav ul li a,.nav-tabs-item{font-weight:400!important}.nav-tabs-item{text-shadow:none!important}"}]}
{"page":{"pagePath":"api-reference-2026-05-27-curie/invoices/retrieve-an-invoice","slug":"/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice","pageMetadata":{"title":"Retrieve an invoice","description":"Download the PDF of an invoice","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /invoices/{id}","href":"/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice","autogeneratedByOpenApi":true},"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: \"Download the PDF of an invoice\"\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":{"title":"Retrieve an invoice","description":"Download the PDF of an invoice","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /invoices/{id}","href":"/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Invoices"],"summary":"Retrieve an invoice","description":"Download the PDF of an invoice","security":["62ff54af-113f-48a5-9544-4f11f1280f2f"],"parameters":["5e5d225d-10d1-4a8d-b67f-1cd6cdeac5d0"],"responses":{"200":"ffaf730f-b0fc-4117-822b-4f373ec0a325","400":"d4d65214-af10-47eb-81c7-64aee788eea5","401":"fa1f00ab-484e-4dfe-aebc-0b575af85dda","403":"9f0f4769-53cd-4f54-89f3-8ba0f4d8ecef","404":"6277560b-8e42-4e2f-a6b0-512628228bdb","500":"17ec4890-5a00-41f9-a295-e1d23d473a76"},"method":"get","type":"path","servers":["3c574865-c954-46d0-a814-22f2d46ad740"],"path":"/invoices/{id}","baseUrlOptions":["https://api.nomos.energy"],"title":"Retrieve an invoice","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5e5d225d-10d1-4a8d-b67f-1cd6cdeac5d0":{"schema":{"type":"string","example":"inv_drjjua6ampd1op2fg98k89x8","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"id","in":"path"}},"responses":{"ffaf730f-b0fc-4117-822b-4f373ec0a325":{"description":"Retrieve the invoice details","content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"Usage invoice","required":["object","id","customer","subscription","invoice_number","month","year","period_start","period_end","period_number","status","type","usage","total"],"properties":{"object":{"type":"string","enum":["invoice"],"isRequired":true,"uniqueKey":"oneOf.0.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","example":"inv_drjjua6ampd1op2fg98k89x8","description":"Unique identifier of the invoice.","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string"},"customer":{"type":"string","example":"cus_a8n8ol7yd4h0wohx824f0bui","description":"ID of the customer the invoice belongs to.","isRequired":true,"uniqueKey":"oneOf.0.customer","typeLabel":"string"},"subscription":{"type":"string","example":"sub_jd8mlscm062jb6ks50tck9gi","description":"ID of the subscription the invoice belongs to.","isRequired":true,"uniqueKey":"oneOf.0.subscription","typeLabel":"string"},"invoice_number":{"type":"string","example":"H62SU12A-003","description":"Human-readable invoice number displayed on the invoice document","isRequired":true,"uniqueKey":"oneOf.0.invoice_number","typeLabel":"string"},"month":{"type":"number","example":4,"description":"Numeric month (1-12) for which the invoice is issued","isRequired":true,"uniqueKey":"oneOf.0.month","typeLabel":"number"},"year":{"type":"number","example":2025,"description":"Four-digit year for which the invoice is issued","isRequired":true,"uniqueKey":"oneOf.0.year","typeLabel":"number"},"period_start":{"type":"string","example":"2025-03-31T22:00:00Z","description":"Timestamp marking the beginning of the billing period (inclusive)","isRequired":true,"uniqueKey":"oneOf.0.period_start","typeLabel":"string"},"period_end":{"type":"string","example":"2025-04-30T22:00:00Z","description":"Timestamp marking the end of the billing period (exclusive)","isRequired":true,"uniqueKey":"oneOf.0.period_end","typeLabel":"string"},"period_number":{"type":"number","example":3,"description":"Sequential number of the billing period within the subscription (1-based)","isRequired":true,"uniqueKey":"oneOf.0.period_number","typeLabel":"number"},"status":{"type":"string","enum":["open","paid","voided"],"example":"open","description":"Current status of the invoice:","isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["usage"],"example":"usage","description":"Discriminator for usage invoices, which bill metered electricity consumption for the period.","isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"enum\u003cstring>"},"usage":{"type":"number","example":100,"description":"Total energy consumption in kilowatt-hours (kWh) during the billing period","isRequired":true,"uniqueKey":"oneOf.0.usage","typeLabel":"number"},"total":{"type":"number","example":110.04,"description":"Total amount due in euros (EUR) including all fees, taxes, and energy costs","isRequired":true,"uniqueKey":"oneOf.0.total","typeLabel":"number"},"issued_at":{"oneOf":[{"type":"string","description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.0.issued_at.oneOf.0","typeLabel":"string"},{"type":"string","description":"Timestamp when the invoice was issued","format":"date-time","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.0.issued_at.oneOf.1","typeLabel":"string\u003cdate-time>"},{"description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.0.issued_at.oneOf.2","typeLabel":"any"},{"type":"null","description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.0.issued_at.oneOf.3","typeLabel":"null"}],"uniqueKey":"oneOf.0.issued_at","typeLabel":"string | string\u003cdate-time> | any | null"},"paid_at":{"oneOf":[{"type":"string","description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.0.paid_at.oneOf.0","typeLabel":"string"},{"type":"string","description":"Timestamp when the invoice was paid","format":"date-time","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.0.paid_at.oneOf.1","typeLabel":"string\u003cdate-time>"},{"description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.0.paid_at.oneOf.2","typeLabel":"any"},{"type":"null","description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.0.paid_at.oneOf.3","typeLabel":"null"}],"uniqueKey":"oneOf.0.paid_at","typeLabel":"string | string\u003cdate-time> | any | null"}},"uniqueKey":"oneOf.0","typeLabel":"Usage invoice · object"},{"type":"object","title":"Prepayment invoice","required":["object","id","customer","subscription","invoice_number","month","year","period_start","period_end","period_number","status","type","total"],"properties":{"object":{"type":"string","enum":["invoice"],"isRequired":true,"uniqueKey":"oneOf.1.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","example":"inv_drjjua6ampd1op2fg98k89x8","description":"Unique identifier of the invoice.","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string"},"customer":{"type":"string","example":"cus_a8n8ol7yd4h0wohx824f0bui","description":"ID of the customer the invoice belongs to.","isRequired":true,"uniqueKey":"oneOf.1.customer","typeLabel":"string"},"subscription":{"type":"string","example":"sub_jd8mlscm062jb6ks50tck9gi","description":"ID of the subscription the invoice belongs to.","isRequired":true,"uniqueKey":"oneOf.1.subscription","typeLabel":"string"},"invoice_number":{"type":"string","example":"H62SU12A-003","description":"Human-readable invoice number displayed on the invoice document","isRequired":true,"uniqueKey":"oneOf.1.invoice_number","typeLabel":"string"},"month":{"type":"number","example":4,"description":"Numeric month (1-12) for which the invoice is issued","isRequired":true,"uniqueKey":"oneOf.1.month","typeLabel":"number"},"year":{"type":"number","example":2025,"description":"Four-digit year for which the invoice is issued","isRequired":true,"uniqueKey":"oneOf.1.year","typeLabel":"number"},"period_start":{"type":"string","example":"2025-03-31T22:00:00Z","description":"Timestamp marking the beginning of the billing period (inclusive)","isRequired":true,"uniqueKey":"oneOf.1.period_start","typeLabel":"string"},"period_end":{"type":"string","example":"2025-04-30T22:00:00Z","description":"Timestamp marking the end of the billing period (exclusive)","isRequired":true,"uniqueKey":"oneOf.1.period_end","typeLabel":"string"},"period_number":{"type":"number","example":3,"description":"Sequential number of the billing period within the subscription (1-based)","isRequired":true,"uniqueKey":"oneOf.1.period_number","typeLabel":"number"},"status":{"type":"string","enum":["open","paid","voided","uncollectible"],"example":"open","description":"Current status of the invoice:","isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["prepayment"],"example":"prepayment","description":"Discriminator for prepayment invoices, which charge a fixed advance amount and carry no metered usage.","isRequired":true,"uniqueKey":"oneOf.1.type","typeLabel":"enum\u003cstring>"},"total":{"type":"number","example":99,"description":"Prepayment amount due in euros (EUR), including taxes","isRequired":true,"uniqueKey":"oneOf.1.total","typeLabel":"number"},"issued_at":{"oneOf":[{"type":"string","description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.1.issued_at.oneOf.0","typeLabel":"string"},{"type":"string","description":"Timestamp when the invoice was issued","format":"date-time","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.1.issued_at.oneOf.1","typeLabel":"string\u003cdate-time>"},{"description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.1.issued_at.oneOf.2","typeLabel":"any"},{"type":"null","description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.1.issued_at.oneOf.3","typeLabel":"null"}],"uniqueKey":"oneOf.1.issued_at","typeLabel":"string | string\u003cdate-time> | any | null"},"paid_at":{"oneOf":[{"type":"string","description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.1.paid_at.oneOf.0","typeLabel":"string"},{"type":"string","description":"Timestamp when the invoice was paid","format":"date-time","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.1.paid_at.oneOf.1","typeLabel":"string\u003cdate-time>"},{"description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.1.paid_at.oneOf.2","typeLabel":"any"},{"type":"null","description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.1.paid_at.oneOf.3","typeLabel":"null"}],"uniqueKey":"oneOf.1.paid_at","typeLabel":"string | string\u003cdate-time> | any | null"}},"uniqueKey":"oneOf.1","typeLabel":"Prepayment invoice · object"},{"type":"object","title":"Void invoice","required":["object","id","customer","subscription","invoice_number","month","year","period_start","period_end","period_number","status","type","voids","total"],"properties":{"object":{"type":"string","enum":["invoice"],"isRequired":true,"uniqueKey":"oneOf.2.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","example":"inv_drjjua6ampd1op2fg98k89x8","description":"Unique identifier of the invoice.","isRequired":true,"uniqueKey":"oneOf.2.id","typeLabel":"string"},"customer":{"type":"string","example":"cus_a8n8ol7yd4h0wohx824f0bui","description":"ID of the customer the invoice belongs to.","isRequired":true,"uniqueKey":"oneOf.2.customer","typeLabel":"string"},"subscription":{"type":"string","example":"sub_jd8mlscm062jb6ks50tck9gi","description":"ID of the subscription the invoice belongs to.","isRequired":true,"uniqueKey":"oneOf.2.subscription","typeLabel":"string"},"invoice_number":{"type":"string","example":"H62SU12A-003","description":"Human-readable invoice number displayed on the invoice document","isRequired":true,"uniqueKey":"oneOf.2.invoice_number","typeLabel":"string"},"month":{"type":"number","example":4,"description":"Numeric month (1-12) for which the invoice is issued","isRequired":true,"uniqueKey":"oneOf.2.month","typeLabel":"number"},"year":{"type":"number","example":2025,"description":"Four-digit year for which the invoice is issued","isRequired":true,"uniqueKey":"oneOf.2.year","typeLabel":"number"},"period_start":{"type":"string","example":"2025-03-31T22:00:00Z","description":"Timestamp marking the beginning of the billing period (inclusive)","isRequired":true,"uniqueKey":"oneOf.2.period_start","typeLabel":"string"},"period_end":{"type":"string","example":"2025-04-30T22:00:00Z","description":"Timestamp marking the end of the billing period (exclusive)","isRequired":true,"uniqueKey":"oneOf.2.period_end","typeLabel":"string"},"period_number":{"type":"number","example":3,"description":"Sequential number of the billing period within the subscription (1-based)","isRequired":true,"uniqueKey":"oneOf.2.period_number","typeLabel":"number"},"status":{"type":"string","enum":["open","paid","voided"],"example":"open","description":"Current status of the invoice:","isRequired":true,"uniqueKey":"oneOf.2.status","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["void"],"example":"void","description":"Discriminator for void invoices (Storno documents) that reverse a previously paid invoice.","isRequired":true,"uniqueKey":"oneOf.2.type","typeLabel":"enum\u003cstring>"},"voids":{"type":"string","example":"inv_mi4f0oda6x9m7gcsvjk0ole1","description":"Identifier of the original invoice that this Storno document voids.","isRequired":true,"uniqueKey":"oneOf.2.voids","typeLabel":"string"},"total":{"type":"number","example":-99,"description":"Amount reversed in euros (EUR), including taxes. Typically negative.","isRequired":true,"uniqueKey":"oneOf.2.total","typeLabel":"number"},"issued_at":{"oneOf":[{"type":"string","description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.2.issued_at.oneOf.0","typeLabel":"string"},{"type":"string","description":"Timestamp when the invoice was issued","format":"date-time","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.2.issued_at.oneOf.1","typeLabel":"string\u003cdate-time>"},{"description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.2.issued_at.oneOf.2","typeLabel":"any"},{"type":"null","description":"Timestamp when the invoice was issued","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.2.issued_at.oneOf.3","typeLabel":"null"}],"uniqueKey":"oneOf.2.issued_at","typeLabel":"string | string\u003cdate-time> | any | null"},"paid_at":{"oneOf":[{"type":"string","description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.2.paid_at.oneOf.0","typeLabel":"string"},{"type":"string","description":"Timestamp when the invoice was paid","format":"date-time","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.2.paid_at.oneOf.1","typeLabel":"string\u003cdate-time>"},{"description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.2.paid_at.oneOf.2","typeLabel":"any"},{"type":"null","description":"Timestamp when the invoice was paid","example":"2024-03-14T12:00:00Z","uniqueKey":"oneOf.2.paid_at.oneOf.3","typeLabel":"null"}],"uniqueKey":"oneOf.2.paid_at","typeLabel":"string | string\u003cdate-time> | any | null"}},"uniqueKey":"oneOf.2","typeLabel":"Void invoice · object"}],"uniqueKey":"","typeLabel":"Usage invoice · object | Prepayment invoice · object | Void invoice · object"},"examples":{"Example":{"title":"Example","value":{"object":"invoice","id":"inv_drjjua6ampd1op2fg98k89x8","customer":"cus_a8n8ol7yd4h0wohx824f0bui","subscription":"sub_jd8mlscm062jb6ks50tck9gi","invoice_number":"H62SU12A-003","month":4,"year":2025,"period_start":"2025-03-31T22:00:00Z","period_end":"2025-04-30T22:00:00Z","period_number":3,"status":"open","type":"usage","usage":100,"total":110.04,"issued_at":"2024-03-14T12:00:00Z","paid_at":"2024-03-14T12:00:00Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"d4d65214-af10-47eb-81c7-64aee788eea5":{"description":"The request is invalid: a field fails validation, breaks a business rule, or the body is not valid JSON. `errors` lists every problem with its field.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST"],"description":"The error code related to the status code.","example":"BAD_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"What is wrong with the field, such as `invalid_type` or `asset_not_found`. `x-extensible-enum` lists the values known today. New values can be added in any API version, so treat an unknown value like any other error of the response's status.","example":"invalid_type","x-extensible-enum":["invalid_type","too_big","too_small","invalid_format","not_multiple_of","unrecognized_keys","invalid_union","invalid_key","invalid_element","invalid_value","custom","unserviceable_zip","ended_subscription","duplicate_grid_reduction","missing_smart_meter","missing_module_1","incompatible_grid_reduction","unsupported_product","unsupported_meter_order","duplicate_meter_order","unsupported_meter","out_of_period_meter_reading","unsupported_meter_reading","duplicate_meter_reading","implausible_meter_reading","duplicate_customer_email","invalid_iban","upgrade_api_version","withdrawal_not_allowed","invalid_termination_date","subscription_not_started","terminated_subscription","missing_household","invalid_household_customer","invalid_household_meter","duplicate_consumption_subscription","invalid_inverter","read_only_asset","duplicate_external_id","asset_has_children","asset_decommissioned","asset_not_found","mixed_households","field_not_allowed","invalid_direction","duplicate_timestamp","asset_not_steerable","mode_not_allowed","slot_missing"],"isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"field":{"type":"string","example":"customer.email","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"Invalid input: expected string, received undefined","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["code","field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Per-field breakdown of a validation or business-rule failure. Omitted for API versions before the structured-errors cutoff.","uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Not an invoice ID":{"title":"Not an invoice ID","summary":"Not an invoice ID","value":{"code":"BAD_REQUEST","message":"Invalid string: must start with \"inv\"","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST","errors":[{"code":"invalid_format","field":"id","message":"Invalid string: must start with \"inv\""}]}},"Unsupported version header":{"title":"Unsupported version header","summary":"Unsupported version header","value":{"code":"BAD_REQUEST","message":"Version header 2026-01-01.foo is invalid.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST"}}},"exampleType":"examples"}},"exampleType":"examples"},"fa1f00ab-484e-4dfe-aebc-0b575af85dda":{"description":"The access token is missing, expired or invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["UNAUTHORIZED"],"description":"The error code related to the status code.","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/UNAUTHORIZED","isRequired":true,"uniqueKey":"docs","typeLabel":"string"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"No token":{"title":"No token","summary":"No token","value":{"code":"UNAUTHORIZED","message":"No authorization header provided.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/UNAUTHORIZED"}},"Expired token":{"title":"Expired token","summary":"Expired token","value":{"code":"UNAUTHORIZED","message":"Token expired","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/UNAUTHORIZED"}},"Invalid token":{"title":"Invalid token","summary":"Invalid token","value":{"code":"UNAUTHORIZED","message":"Invalid or malformed token","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/UNAUTHORIZED"}}},"exampleType":"examples"}},"exampleType":"examples"},"9f0f4769-53cd-4f54-89f3-8ba0f4d8ecef":{"description":"The access token is valid but not allowed to use this endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["FORBIDDEN"],"description":"The error code related to the status code.","example":"FORBIDDEN","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/FORBIDDEN","isRequired":true,"uniqueKey":"docs","typeLabel":"string"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Token without scope":{"title":"Token without scope","summary":"Token without scope","value":{"code":"FORBIDDEN","message":"Insufficient scope: read:* required.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/FORBIDDEN"}},"Customer token without customer":{"title":"Customer token without customer","summary":"Customer token without customer","value":{"code":"FORBIDDEN","message":"Customer not found.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/FORBIDDEN"}}},"exampleType":"examples"}},"exampleType":"examples"},"6277560b-8e42-4e2f-a6b0-512628228bdb":{"description":"A resource in the path or the body does not exist or belongs to another organization, or the endpoint does not exist in the API version of your token.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["NOT_FOUND"],"description":"The error code related to the status code.","example":"NOT_FOUND","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/NOT_FOUND","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"What is wrong with the field, such as `invalid_type` or `asset_not_found`. `x-extensible-enum` lists the values known today. New values can be added in any API version, so treat an unknown value like any other error of the response's status.","example":"invalid_type","x-extensible-enum":["invalid_type","too_big","too_small","invalid_format","not_multiple_of","unrecognized_keys","invalid_union","invalid_key","invalid_element","invalid_value","custom","unserviceable_zip","ended_subscription","duplicate_grid_reduction","missing_smart_meter","missing_module_1","incompatible_grid_reduction","unsupported_product","unsupported_meter_order","duplicate_meter_order","unsupported_meter","out_of_period_meter_reading","unsupported_meter_reading","duplicate_meter_reading","implausible_meter_reading","duplicate_customer_email","invalid_iban","upgrade_api_version","withdrawal_not_allowed","invalid_termination_date","subscription_not_started","terminated_subscription","missing_household","invalid_household_customer","invalid_household_meter","duplicate_consumption_subscription","invalid_inverter","read_only_asset","duplicate_external_id","asset_has_children","asset_decommissioned","asset_not_found","mixed_households","field_not_allowed","invalid_direction","duplicate_timestamp","asset_not_steerable","mode_not_allowed","slot_missing"],"isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"field":{"type":"string","example":"customer.email","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"Invalid input: expected string, received undefined","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["code","field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Per-field breakdown of a validation or business-rule failure. Omitted for API versions before the structured-errors cutoff.","uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Unknown invoice":{"title":"Unknown invoice","summary":"Unknown invoice","value":{"code":"NOT_FOUND","message":"Invoice not found","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/NOT_FOUND"}},"Endpoint not in your API version":{"title":"Endpoint not in your API version","summary":"Endpoint not in your API version","value":{"code":"NOT_FOUND","message":"There is no GET /invoices/{id} in API version 2025-12-01.chucky.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/NOT_FOUND"}}},"exampleType":"examples"}},"exampleType":"examples"},"17ec4890-5a00-41f9-a295-e1d23d473a76":{"description":"Something went wrong on our side. Retry later, and send us the `requestId` if it persists.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["INTERNAL_SERVER_ERROR"],"description":"The error code related to the status code.","example":"INTERNAL_SERVER_ERROR","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/INTERNAL_SERVER_ERROR","isRequired":true,"uniqueKey":"docs","typeLabel":"string"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Unexpected error":{"title":"Unexpected error","summary":"Unexpected error","value":{"code":"INTERNAL_SERVER_ERROR","message":"Internal Server Error","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/INTERNAL_SERVER_ERROR"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"62ff54af-113f-48a5-9544-4f11f1280f2f":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"}}},"servers":{"3c574865-c954-46d0-a814-22f2d46ad740":{"url":"https://api.nomos.energy","description":"production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"openapi/openapi.curie.json"},"subdomain":"riverslate","siteName":"Nomos","title":"Retrieve an invoice - Nomos","navMaps":{"firstHrefInVersion":{"2026-11-16.faraday (preview)":{"href":"/api-reference-2026-11-16-faraday/invoices/retrieve-an-invoice","matchLevel":1},"2026-09-08.gauss":{"href":"/api-reference/invoices/retrieve-an-invoice","matchLevel":1},"2026-05-27.curie":{"href":"/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice","matchLevel":0},"2026-01-29.edison":{"href":"/api-reference-2026-01-29-edison/invoices/retrieve-an-invoice","matchLevel":1},"2025-12-16.batman":{"href":"/api-reference-2025-12-16-batman/invoices/retrieve-an-invoice","matchLevel":1},"2025-12-01.chucky":{"href":"/api-reference-2025-12-01-chucky/invoices/retrieve-an-invoice","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T15:31:50.855Z","originalFileLocation":"api-reference-2026-05-27-curie/invoices/retrieve-an-invoice.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}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=\"Download the PDF of an invoice\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nomos\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_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/riverslate/iILQM7kXCjcV9kRT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_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/riverslate/iILQM7kXCjcV9kRT/_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/riverslate/iILQM7kXCjcV9kRT/_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/riverslate/iILQM7kXCjcV9kRT/_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/riverslate/iILQM7kXCjcV9kRT/_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/riverslate/iILQM7kXCjcV9kRT/_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/riverslate/iILQM7kXCjcV9kRT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve an invoice - Nomos\">\u003cmeta data-mint-head property=\"og:description\" content=\"Download the PDF of an invoice\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nomos\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://riverslate.mintlify.site/_mintlify/api/og/v2?division=Invoices\u0026amp;title=Retrieve+an+invoice\u0026amp;description=Download+the+PDF+of+an+invoice\u0026amp;theme=9f06b09645d9ae8ac0235d4f\u0026amp;signature=8c931a4f86f40e00af5d511fcbab38822e11397df0ba2af0d0f3143c2af527fd\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Retrieve an invoice - Nomos\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Download the PDF of an invoice\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://riverslate.mintlify.site/_mintlify/api/og/v2?division=Invoices\u0026amp;title=Retrieve+an+invoice\u0026amp;description=Download+the+PDF+of+an+invoice\u0026amp;theme=9f06b09645d9ae8ac0235d4f\u0026amp;signature=8c931a4f86f40e00af5d511fcbab38822e11397df0ba2af0d0f3143c2af527fd\">\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/riverslate/iILQM7kXCjcV9kRT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nomos\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1b1915\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nomos.energy/#organization\",\"name\":\"Nomos\",\"url\":\"https://docs.nomos.energy\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/riverslate/0nQqndf6SGR4MtUC/logo/light.svg?fit=max\u0026auto=format\u0026n=0nQqndf6SGR4MtUC\u0026q=85\u0026s=99c5d32286bf07989f99539ad1584d34\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nomos.energy#website\",\"name\":\"Nomos\",\"url\":\"https://docs.nomos.energy\",\"publisher\":{\"@id\":\"https://docs.nomos.energy/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice#webpage\",\"url\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice\",\"name\":\"Retrieve an invoice\",\"description\":\"Download the PDF of an invoice\",\"dateModified\":\"2026-11-16T15:31:50.855Z\",\"isPartOf\":{\"@id\":\"https://docs.nomos.energy#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/plans/list-plans\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve an invoice\",\"item\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice#apireference\",\"headline\":\"Retrieve an invoice\",\"name\":\"Retrieve an invoice\",\"description\":\"Download the PDF of an invoice\",\"url\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nomos.energy/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice#webpage\"},\"dateModified\":\"2026-11-16T15:31:50.855Z\",\"publisher\":{\"@id\":\"https://docs.nomos.energy/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nomos.energy#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nomos\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Nomos\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice.md","siteName":"Nomos","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/home"}]},{"tab":"API Reference","icon":"code","versions":[{"version":"2026-11-16.faraday (preview)","pages":[{"title":"2026-11-16.faraday (preview)","href":"/api-reference-2026-11-16-faraday/invoices/retrieve-an-invoice"}]},{"version":"2026-09-08.gauss","default":true,"pages":[{"title":"2026-09-08.gauss","href":"/api-reference/invoices/retrieve-an-invoice"}]},{"version":"2026-05-27.curie","groups":[{"group":" ","pages":[{"title":"API Reference","sidebarTitle":"Introduction","href":"/api-references/introduction"},{"title":"Authentication","href":"/api-references/authentication"},{"title":"Versioning","href":"/api-references/versioning"},{"title":"Pagination","href":"/api-references/pagination"},{"title":"Filtering","href":"/api-references/filtering"},{"title":"Errors","href":"/api-references/errors"},{"title":"Changelog","href":"/api-references/changelog"}]},{"group":"API Reference","pages":[{"group":"Plans","pages":[{"title":"List plans","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /plans","href":"/api-reference-2026-05-27-curie/plans/list-plans"},{"title":"Retrieve a plan","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /plans/{id}","href":"/api-reference-2026-05-27-curie/plans/retrieve-a-plan"},{"title":"Retrieve a quote","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /plans/{id}/quote","href":"/api-reference-2026-05-27-curie/plans/retrieve-a-quote"}]},{"group":"Leads","pages":[{"title":"List leads","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /leads","href":"/api-reference-2026-05-27-curie/leads/list-leads"},{"title":"Create a lead","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /leads","href":"/api-reference-2026-05-27-curie/leads/create-a-lead"},{"title":"Retrieve a lead","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /leads/{id}","href":"/api-reference-2026-05-27-curie/leads/retrieve-a-lead"}]},{"group":"Subscriptions","pages":[{"title":"Retrieve a subscription","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /subscriptions/{id}","href":"/api-reference-2026-05-27-curie/subscriptions/retrieve-a-subscription"},{"title":"Update a subscription","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json patch /subscriptions/{id}","href":"/api-reference-2026-05-27-curie/subscriptions/update-a-subscription"},{"title":"Terminate a subscription","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /subscriptions/{id}/terminate","href":"/api-reference-2026-05-27-curie/subscriptions/terminate-a-subscription"},{"title":"List subscriptions","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /subscriptions","href":"/api-reference-2026-05-27-curie/subscriptions/list-subscriptions"},{"title":"Create a subscription","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /subscriptions","href":"/api-reference-2026-05-27-curie/subscriptions/create-a-subscription"}]},{"group":"Customers","pages":[{"title":"Retrieve a customer","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /customers/{id}","href":"/api-reference-2026-05-27-curie/customers/retrieve-a-customer"},{"title":"Update a customer","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json patch /customers/{id}","href":"/api-reference-2026-05-27-curie/customers/update-a-customer"},{"title":"List customers","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /customers","href":"/api-reference-2026-05-27-curie/customers/list-customers"}]},{"group":"Usage","pages":[{"title":"Retrieve usage data","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /subscriptions/{id}/usage","href":"/api-reference-2026-05-27-curie/usage/retrieve-usage-data"},{"title":"List meter readings","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /meter-readings","href":"/api-reference-2026-05-27-curie/usage/list-meter-readings"},{"title":"Create a meter reading","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /meter-readings","href":"/api-reference-2026-05-27-curie/usage/create-a-meter-reading"},{"title":"Create a load forecast","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /load-forecasts","href":"/api-reference-2026-05-27-curie/usage/create-a-load-forecast"}]},{"group":"Prices","pages":[{"title":"Retrieve a subscription price time series","description":"Retrieve a price object for a given subscription. For a consumption subscription this is the variable price time series the customer pays and can optimize consumption against; for a feed-in subscription it is the payout the customer is credited per kWh, based on EPEX day-ahead spot prices and without grid fees. All prices are inclusive of VAT, except feed-in payouts to a VAT-exempt customer.","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /subscriptions/{id}/prices","href":"/api-reference-2026-05-27-curie/prices/retrieve-a-subscription-price-time-series"}]},{"group":"Invoices","pages":[{"title":"Retrieve an invoice","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /invoices/{id}","href":"/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice"},{"title":"List invoices","description":"Invoices summarise the amounts owed/payed for a subscription. Usage invoices (`type: \"usage\"`) bill the metered electricity consumption of a billing period and include all line items such as energy, grid fees and taxes. Prepayment invoices (`type: \"prepayment\"`) charge a fixed advance amount and carry no usage; an unpaid prepayment that is cancelled surfaces with `status: \"uncollectible\"`. Void invoices (`type: \"void\"`) are Storno documents that reverse a previously paid invoice and reference the original via `voids`. Voided originals are included with `status: \"voided\"`. The related PDFs are available via the `/invoices/{id}/file` endpoint. Customer users will only see their own. Use filter[subscription][eq]=\u003cid> to scope to a single subscription.","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /invoices","href":"/api-reference-2026-05-27-curie/invoices/list-invoices"},{"title":"Retrieve an invoice PDF","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /invoices/{id}/file","href":"/api-reference-2026-05-27-curie/invoices/retrieve-an-invoice-pdf"}]},{"group":"Smart Meter Orders","pages":[{"title":"Retrieve a smart meter order","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /meter-orders/{id}","href":"/api-reference-2026-05-27-curie/smart-meter-orders/retrieve-a-smart-meter-order"},{"title":"List smart meter orders","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /meter-orders","href":"/api-reference-2026-05-27-curie/smart-meter-orders/list-smart-meter-orders"},{"title":"Create a smart meter order","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /meter-orders","href":"/api-reference-2026-05-27-curie/smart-meter-orders/create-a-smart-meter-order"}]},{"group":"Grid Fee Reductions","pages":[{"title":"List grid fee reductions","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /grid-fee-reductions","href":"/api-reference-2026-05-27-curie/grid-fee-reductions/list-grid-fee-reductions"},{"title":"Create a grid fee reduction","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /grid-fee-reductions","href":"/api-reference-2026-05-27-curie/grid-fee-reductions/create-a-grid-fee-reduction"},{"title":"Retrieve a grid fee reduction","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /grid-fee-reductions/{id}","href":"/api-reference-2026-05-27-curie/grid-fee-reductions/retrieve-a-grid-fee-reduction"}]},{"group":"Market Partners","pages":[{"title":"List market partners","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /market-partners","href":"/api-reference-2026-05-27-curie/market-partners/list-market-partners"}]},{"group":"Events","pages":[{"title":"Retrieve an event","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /events/{id}","href":"/api-reference-2026-05-27-curie/events/retrieve-an-event"}]},{"group":"Authentication","pages":[{"title":"Create a token","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /oauth/token","href":"/api-reference-2026-05-27-curie/authentication/create-a-token"},{"title":"Authorize","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json get /oauth/authorize","href":"/api-reference-2026-05-27-curie/authentication/authorize"},{"title":"Create a magic link (customer portal)","deprecated":null,"version":null,"openapi":"/openapi/openapi.curie.json post /admin/magic_link","href":"/api-reference-2026-05-27-curie/authentication/create-a-magic-link-customer-portal"}]}]}]},{"version":"2026-01-29.edison","pages":[{"title":"2026-01-29.edison","href":"/api-reference-2026-01-29-edison/invoices/retrieve-an-invoice"}]},{"version":"2025-12-16.batman","pages":[{"title":"2025-12-16.batman","href":"/api-reference-2025-12-16-batman/invoices/retrieve-an-invoice"}]},{"version":"2025-12-01.chucky","pages":[{"title":"2025-12-01.chucky","href":"/api-reference-2025-12-01-chucky/invoices/retrieve-an-invoice"}]}]},{"tab":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks","href":"/webhooks/introduction"}]}]},"basePath":"","title":"Retrieve an invoice - Nomos","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}