{
"code": "invalid_request",
"detail": "The request is not valid. A parameter is missing, malformed, or out of range. See the `errors` array for the fields that failed.",
"errors": [],
"doc_url": "https://www.finseed.es/docs/api-reference/errors#invalid_request"
}
{
"code": "unauthorized",
"detail": "Authentication failed. Send your API key as a bearer token in the `Authorization` header. Keys are scoped to one environment, so a test key cannot read live data and vice versa.",
"errors": [],
"doc_url": "https://www.finseed.es/docs/api-reference/errors#unauthorized"
}
{
"code": "internal_error",
"detail": "Something went wrong on our side. The request did not complete and can be retried safely.",
"errors": [],
"doc_url": "https://www.finseed.es/docs/api-reference/errors#internal_error"
}
Invoices
List invoices
Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow next_url to page through the rest.
{
"code": "invalid_request",
"detail": "The request is not valid. A parameter is missing, malformed, or out of range. See the `errors` array for the fields that failed.",
"errors": [],
"doc_url": "https://www.finseed.es/docs/api-reference/errors#invalid_request"
}
{
"code": "unauthorized",
"detail": "Authentication failed. Send your API key as a bearer token in the `Authorization` header. Keys are scoped to one environment, so a test key cannot read live data and vice versa.",
"errors": [],
"doc_url": "https://www.finseed.es/docs/api-reference/errors#unauthorized"
}
{
"code": "internal_error",
"detail": "Something went wrong on our side. The request did not complete and can be retried safely.",
"errors": [],
"doc_url": "https://www.finseed.es/docs/api-reference/errors#internal_error"
}
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Finseed","description":"Documentación oficial de Finseed: guías de integración con Shopify, Stripe, PrestaShop y WooCommerce para facturación Verifactu automática.","colors":{"primary":"#2563eb","light":"#dbeafe","dark":"#18181b"},"logo":{"light":"https://mintcdn.com/easyverifactu-docs/eHxJd3kRdehy8fGT/logo/finseed-logo.svg?fit=max\u0026auto=format\u0026n=eHxJd3kRdehy8fGT\u0026q=85\u0026s=da8e7a9fc54301ce10ead986bbe819b0","dark":"https://mintcdn.com/easyverifactu-docs/eHxJd3kRdehy8fGT/logo/finseed-logo-white.svg?fit=max\u0026auto=format\u0026n=eHxJd3kRdehy8fGT\u0026q=85\u0026s=fa4ddbcddb4dd3dc686fa9b704edc99a"},"favicon":"https://mintcdn.com/easyverifactu-docs/j0SSrNob17AieSq-/favicon.ico?fit=max\u0026auto=format\u0026n=j0SSrNob17AieSq-\u0026q=85\u0026s=d012b6a25ec757842718d97770600523","navbar":{"links":[{"href":"https://www.finseed.es/contacto","label":"Ayuda"}],"primary":{"type":"button","label":"Iniciar sesión","href":"https://www.finseed.es/app"}},"footer":{"socials":{}},"seo":{"metatags":{"canonical":"https://www.finseed.es/docs","og:locale":"es_ES","og:type":"article","og:site_name":"Finseed"},"indexing":"navigable"},"fonts":{"family":"Geist"},"integrations":{"ga4":{"measurementId":"G-SE29E2FZVZ"},"intercom":{"appId":"uckfocrt"}},"errors":{"404":{"redirect":true,"title":"Página no encontrada"}},"contextual":{"options":["copy","view","assistant","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"languages":[{"language":"es","default":true,"hidden":false,"href":"https://www.finseed.es/docs"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"easyverifactu-docs","hasAudioNarration":false,"actualSubdomain":"easyverifactu-docs","customDomains":["www.finseed.es"],"gitSource":{"type":"github","owner":"easyverifactu","repo":"easyverifactu","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae473e6f07304f3346664a8","collectionId":"81d68e87-c853-423c-bea1-432fbf11ec2e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae473e6f07304f3346664a8"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae473e6f07304f3346664a8","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Stripe","count":31},{"language":"default","tag":"Inicio","count":28},{"language":"default","tag":"General","count":22},{"language":"default","tag":"API Reference","count":17},{"language":"default","tag":"Shopify","count":16},{"language":"default","tag":"PrestaShop","count":14},{"language":"default","tag":"Stripe Payments","count":13},{"language":"default","tag":"WooCommerce","count":10},{"language":"default","tag":"Stripe Billing","count":8},{"language":"default","tag":"Invoices","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":"#content-area{max-width:720px}#content-container>div:has(>#content-area){column-gap:0;padding-left:0}#navbar div:has(>a img){flex:none}#navbar a img{height:1rem}#navbar div.flex.items-center.gap-4:has(.nav-tabs){flex:1}#navbar div:has(>div>.nav-tabs){justify-content:flex-start;margin-left:0}#navbar nav[aria-label=Main]{margin-left:auto}.nav-tabs{align-items:center;gap:4px}.nav-tabs a.nav-tabs-item{height:auto;padding:4px 10px;border-radius:6px;transition:background-color .15s ease}.nav-tabs a.nav-tabs-item[data-active=true]{background-color:rgba(37,99,235,.1);color:#2563eb}.dark .nav-tabs a.nav-tabs-item[data-active=true]{background-color:rgba(219,234,254,.15);color:#93c5fd}.nav-tabs a.nav-tabs-item:not([data-active=true]):hover{background-color:rgba(0,0,0,.05)}.dark .nav-tabs a.nav-tabs-item:not([data-active=true]):hover{background-color:rgba(255,255,255,.07)}"}],"page":{"pagePath":"api-reference/invoices/list-invoices","slug":"/api-reference/invoices/list-invoices","pageMetadata":{"title":"List invoices","description":"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow `next_url` to page through the rest.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/invoices","href":"/api-reference/invoices/list-invoices","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow \", _jsx(_components.code, {\n children: \"next_url\"\n }), \" to page through the rest.\"]\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":"List invoices","description":"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow `next_url` to page through the rest.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/invoices","href":"/api-reference/invoices/list-invoices","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listInvoices","tags":["Invoices"],"summary":"List invoices","description":"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow `next_url` to page through the rest.","parameters":["c97ec856-37ff-4762-85f6-44a33a77ae80","ba7bb6b3-48b4-490f-ae62-28d790777ea3","bf23ddec-ff87-4b36-ab33-b5cb560254d1","534eef91-6f3a-40bc-8789-5b8a3e0133b6","6cf8c899-4e74-4c13-a974-59ec706657b9"],"responses":{"200":"38f9cf6d-8536-49c7-86e7-283e74aa898a","400":"20b2dc83-6633-4151-8b7c-3093ea1cd37b","401":"e01d9000-8162-4a8a-b61d-eacce8d01470","500":"78897dac-8807-4eac-abc0-228f6e66df82"},"method":"get","type":"path","servers":["fcd86d28-6eaf-472b-9e4a-903bb52993a9"],"security":["43ad838b-f198-487f-9ceb-ed827457cefe"],"path":"/v1/invoices","baseUrlOptions":["https://api.finseed.es"],"title":"List invoices","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c97ec856-37ff-4762-85f6-44a33a77ae80":{"name":"limit","in":"query","required":false,"description":"Maximum number of invoices to return (1–100).","schema":{"default":25,"description":"Maximum number of invoices to return (1–100).\nMaximum number of invoices to return (1-100).","example":25,"type":"integer","minimum":1,"maximum":100,"isRequired":false,"uniqueKey":"","typeLabel":"integer"}},"ba7bb6b3-48b4-490f-ae62-28d790777ea3":{"name":"starting_after","in":"query","required":false,"description":"Opaque cursor: return invoices after this invoice id.","schema":{"description":"Opaque cursor: return invoices after this invoice id.\nCursor: return invoices after this invoice id.","example":"inv_clx123abc456","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"bf23ddec-ff87-4b36-ab33-b5cb560254d1":{"name":"external_customer_id","in":"query","required":false,"description":"Filter to invoices for this external customer id (exact).","schema":{"description":"Filter to invoices for this external customer id (exact).","example":"cus_9aZ","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"534eef91-6f3a-40bc-8789-5b8a3e0133b6":{"name":"email","in":"query","required":false,"description":"Filter to invoices with this recipient email (exact, case-insensitive).","schema":{"description":"Filter to invoices with this recipient email (exact, case-insensitive).","example":"[email protected]","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"6cf8c899-4e74-4c13-a974-59ec706657b9":{"name":"number","in":"query","required":false,"description":"Filter to the invoice with this human-readable number (exact, case-insensitive).","schema":{"description":"Filter to the invoice with this human-readable number (exact, case-insensitive).","example":"2026-000123","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}}},"responses":{"38f9cf6d-8536-49c7-86e7-283e74aa898a":{"description":"A cursor-paginated page of invoices.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Opaque, prefixed invoice identifier.","example":"inv_clx123abc456","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","description":"Lifecycle status of the invoice. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: issued, voided.","example":"issued","isRequired":true,"uniqueKey":"data.items.[INDEX].status","typeLabel":"string"},"number":{"type":"string","description":"Human-readable invoice number.","example":"2026-000123","isRequired":true,"uniqueKey":"data.items.[INDEX].number","typeLabel":"string"},"currency":{"type":"string","description":"Lowercase ISO 4217 currency code.","example":"eur","isRequired":true,"uniqueKey":"data.items.[INDEX].currency","typeLabel":"string"},"subtotal":{"type":"integer","description":"Net total before tax, in minor units (cents) of the currency.","example":8300,"isRequired":true,"uniqueKey":"data.items.[INDEX].subtotal","typeLabel":"integer"},"tax":{"type":"integer","description":"Total tax, in minor units (cents) of the currency.","example":1743,"isRequired":true,"uniqueKey":"data.items.[INDEX].tax","typeLabel":"integer"},"total":{"type":"integer","description":"Gross total including tax, in minor units (cents) of the currency. Always equals subtotal + tax.","example":10043,"isRequired":true,"uniqueKey":"data.items.[INDEX].total","typeLabel":"integer"},"recipient_name":{"oneOf":[{"type":"string","description":"Fiscal name of the invoice recipient (company or person), or null when none is recorded.","example":"ACME, S.L.","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fiscal name of the invoice recipient (company or person), or null when none is recorded.","example":"ACME, S.L.","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient_name","typeLabel":"string | null"},"recipient_tax_id":{"oneOf":[{"type":"string","description":"Tax identifier of the recipient (e.g. NIF/CIF), or null when none is recorded.","example":"B12345678","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient_tax_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Tax identifier of the recipient (e.g. NIF/CIF), or null when none is recorded.","example":"B12345678","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient_tax_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient_tax_id","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"Recipient email, or null when none is recorded.","example":"[email protected]","isRequired":true,"uniqueKey":"data.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recipient email, or null when none is recorded.","example":"[email protected]","isRequired":true,"uniqueKey":"data.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].email","typeLabel":"string | null"},"external_customer_id":{"oneOf":[{"type":"string","description":"Customer identifier from the originating integration, or null when unavailable.","example":"cus_9aZ","isRequired":true,"uniqueKey":"data.items.[INDEX].external_customer_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Customer identifier from the originating integration, or null when unavailable.","example":"cus_9aZ","isRequired":true,"uniqueKey":"data.items.[INDEX].external_customer_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].external_customer_id","typeLabel":"string | null"},"external_id":{"oneOf":[{"type":"string","description":"The `external_id` supplied when the invoice was created through the API, or null when none was given.","example":"order-84312","isRequired":true,"uniqueKey":"data.items.[INDEX].external_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The `external_id` supplied when the invoice was created through the API, or null when none was given.","example":"order-84312","isRequired":true,"uniqueKey":"data.items.[INDEX].external_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].external_id","typeLabel":"string | null"},"invoice_date":{"type":"string","description":"Invoice issue date, RFC 3339 in UTC.","example":"2026-06-01T09:30:00Z","isRequired":true,"uniqueKey":"data.items.[INDEX].invoice_date","typeLabel":"string"},"operation_date":{"type":"string","description":"Date the underlying operation took place, RFC 3339 in UTC. Often equal to invoice_date.","example":"2026-06-01T09:30:00Z","isRequired":true,"uniqueKey":"data.items.[INDEX].operation_date","typeLabel":"string"},"created_at":{"type":"string","description":"Creation timestamp, RFC 3339 in UTC.","example":"2026-06-01T09:30:00Z","isRequired":true,"uniqueKey":"data.items.[INDEX].created_at","typeLabel":"string"},"type":{"type":"string","description":"Whether this is a complete invoice (identified recipient) or a simplified invoice (ticket). This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: complete, simplified.","example":"complete","isRequired":true,"uniqueKey":"data.items.[INDEX].type","typeLabel":"string"},"number_series_id":{"type":"string","description":"Identifier of the number series the invoice was issued on. See the Number Series resource.","example":"ns_clx456def789","isRequired":true,"uniqueKey":"data.items.[INDEX].number_series_id","typeLabel":"string"},"recipient":{"oneOf":[{"type":"object","description":"Full recipient block as recorded on the document, or null when no recipient data exists (simplified invoices). The flat recipient_name/recipient_tax_id/email fields remain as convenience aliases.","required":["name","company_name","tax_id","tax_id_type","tax_id_country","email","address"],"properties":{"name":{"oneOf":[{"type":"string","description":"Name of the recipient (person or business), or null when none is recorded.","example":"ACME, S.L.","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the recipient (person or business), or null when none is recorded.","example":"ACME, S.L.","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.name","typeLabel":"string | null"},"company_name":{"oneOf":[{"type":"string","description":"Company name when it was recorded separately from `name`, or null.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.company_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Company name when it was recorded separately from `name`, or null.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.company_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.company_name","typeLabel":"string | null"},"tax_id":{"oneOf":[{"type":"string","description":"Tax identifier (e.g. NIF/CIF), or null.","example":"B12345678","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Tax identifier (e.g. NIF/CIF), or null.","example":"B12345678","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id","typeLabel":"string | null"},"tax_id_type":{"oneOf":[{"type":"string","description":"Kind of tax identifier, or null when none is recorded. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: es_nif, eu_vat, passport, official_document, residence_certificate, other, not_registered.","example":"es_nif","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Kind of tax identifier, or null when none is recorded. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: es_nif, eu_vat, passport, official_document, residence_certificate, other, not_registered.","example":"es_nif","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id_type","typeLabel":"string | null"},"tax_id_country":{"oneOf":[{"type":"string","description":"Country the tax id belongs to, or null: the ISO 3166-1 alpha-2 code, except with eu_vat, which carries the EU VAT prefix code (EL for Greece, XI for Northern Ireland).","example":"ES","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id_country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Country the tax id belongs to, or null: the ISO 3166-1 alpha-2 code, except with eu_vat, which carries the EU VAT prefix code (EL for Greece, XI for Northern Ireland).","example":"ES","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id_country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.tax_id_country","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"Recipient email, or null.","example":"[email protected]","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recipient email, or null.","example":"[email protected]","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.email","typeLabel":"string | null"},"address":{"oneOf":[{"type":"object","description":"Postal address, or null when no address field is recorded.","required":["line1","line2","postal_code","city","country"],"properties":{"line1":{"oneOf":[{"type":"string","description":"Street address, or null when none is recorded.","example":"Calle Mayor 1","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.line1.oneOf.0","typeLabel":"string"},{"type":"null","description":"Street address, or null when none is recorded.","example":"Calle Mayor 1","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.line1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.line1","typeLabel":"string | null"},"line2":{"oneOf":[{"type":"string","description":"Additional address line, or null.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.line2.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional address line, or null.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.line2.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.line2","typeLabel":"string | null"},"postal_code":{"oneOf":[{"type":"string","description":"Postal code, or null.","example":"28001","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.postal_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Postal code, or null.","example":"28001","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.postal_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.postal_code","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","description":"City, or null.","example":"Madrid","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City, or null.","example":"Madrid","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.city","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","description":"ISO 3166-1 alpha-2 country code, or null.","example":"ES","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.country.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 3166-1 alpha-2 country code, or null.","example":"ES","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0.country","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.0","typeLabel":"object"},{"type":"null","description":"Postal address, or null when no address field is recorded.","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0.address","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.0","typeLabel":"object"},{"type":"null","description":"Full recipient block as recorded on the document, or null when no recipient data exists (simplified invoices). The flat recipient_name/recipient_tax_id/email fields remain as convenience aliases.","isRequired":true,"uniqueKey":"data.items.[INDEX].recipient.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].recipient","typeLabel":"object | null"},"pdf_url":{"type":"string","description":"Signed link to the invoice PDF, valid for at least 24 hours from the moment this response was produced. Fetch a fresh one anytime by re-reading the invoice, or use the download endpoint. The PDF is generated shortly after creation; downloading earlier just takes a moment longer.","example":"https://api.finseed.es/v1/invoices/inv_clx123abc456/file?token=...","isRequired":true,"uniqueKey":"data.items.[INDEX].pdf_url","typeLabel":"string"},"issuing_system":{"type":"string","description":"The invoicing system that issued the invoice. It is set when the invoice is created and never changes. `verifactu`: issued with Verifactu, the system that registers invoices with the tax agency (AEAT). `non_adapted`: issued without Verifactu, so no invoice record is sent to the tax agency and `verifactu` is null. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: verifactu, non_adapted.","example":"verifactu","isRequired":true,"uniqueKey":"data.items.[INDEX].issuing_system","typeLabel":"string"},"verifactu":{"oneOf":[{"type":"object","description":"Verifactu artifacts and AEAT registration state. Null when `issuing_system` is `non_adapted`, because that system creates no Verifactu record. Also null for legacy invoices imported before Verifactu tracking existed.","required":["status","hash","qr_url","error"],"properties":{"status":{"type":"string","description":"AEAT registration status. `pending` means the record is queued for submission; `registered` means AEAT accepted it; `registered_with_errors` means AEAT accepted it but flagged issues that need a correction; `rejected` means AEAT refused it; `skipped` means the record was deliberately never submitted. Registration is asynchronous: poll the invoice until it leaves `pending`. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: pending, registered, registered_with_errors, rejected, skipped.","example":"registered","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.status","typeLabel":"string"},"hash":{"type":"string","description":"Chained Verifactu fingerprint (huella) of the invoice record, computed at issue time. Part of the legal record; safe to archive.","example":"B11F3A0151ADA655A9A0A4A64F32F440BE0EE0F5A695BB2E4DC5C0C0AF6E8D2A","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.hash","typeLabel":"string"},"qr_url":{"type":"string","description":"AEAT verification URL encoded in the invoice QR. Encode this URL as a QR code if you render your own documents; the PDF from this API already includes it. Test-environment invoices point at a simulator instead of AEAT.","example":"https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?nif=B12345678\u0026numserie=F-000123\u0026fecha=01-06-2026\u0026importe=100.43","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.qr_url","typeLabel":"string"},"error":{"oneOf":[{"type":"object","description":"Present when `status` is `registered_with_errors` or `rejected` and the tax agency reported a reason; null otherwise.","required":["code","message"],"properties":{"code":{"oneOf":[{"type":"string","description":"Error code reported by the tax agency (AEAT), verbatim, or null when only a message is available.","example":"1142","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error.oneOf.0.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Error code reported by the tax agency (AEAT), verbatim, or null when only a message is available.","example":"1142","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error.oneOf.0.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error.oneOf.0.code","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","description":"Error message reported by the tax agency, verbatim (Spanish), or null.","example":"El NIF del destinatario no está identificado en el censo de la AEAT.","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error.oneOf.0.message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Error message reported by the tax agency, verbatim (Spanish), or null.","example":"El NIF del destinatario no está identificado en el censo de la AEAT.","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error.oneOf.0.message.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error.oneOf.0.message","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error.oneOf.0","typeLabel":"object"},{"type":"null","description":"Present when `status` is `registered_with_errors` or `rejected` and the tax agency reported a reason; null otherwise.","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0.error","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.0","typeLabel":"object"},{"type":"null","description":"Verifactu artifacts and AEAT registration state. Null when `issuing_system` is `non_adapted`, because that system creates no Verifactu record. Also null for legacy invoices imported before Verifactu tracking existed.","isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].verifactu","typeLabel":"object | null"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Opaque, prefixed line-item identifier.","example":"ili_clx789def012","isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].id","typeLabel":"string"},"description":{"type":"string","description":"Description of the goods or service.","example":"Consulting services","isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].description","typeLabel":"string"},"sku":{"oneOf":[{"type":"string","description":"Stock-keeping unit, or null when none is recorded.","example":"SVC-01","isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].sku.oneOf.0","typeLabel":"string"},{"type":"null","description":"Stock-keeping unit, or null when none is recorded.","example":"SVC-01","isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].sku.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].sku","typeLabel":"string | null"},"quantity":{"type":"integer","description":"Number of units billed on this line.","example":2,"isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].quantity","typeLabel":"integer"},"unit_amount":{"type":"integer","description":"Net price of a single unit before tax, in minor units (cents).","example":4150,"isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].unit_amount","typeLabel":"integer"},"subtotal":{"type":"integer","description":"Net total for this line before tax, in minor units (cents).","example":8300,"isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].subtotal","typeLabel":"integer"},"tax":{"type":"integer","description":"Tax total for this line, in minor units (cents).","example":1743,"isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].tax","typeLabel":"integer"},"total":{"type":"integer","description":"Gross total for this line including tax, in minor units (cents).","example":10043,"isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].total","typeLabel":"integer"},"tax_items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Human-readable tax label as it appears on the invoice, e.g. \"IVA 21%\".","example":"IVA 21%","isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].tax_items.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","description":"Tax category this line is subject to. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: vat, igic, ipsi, es_recargo_equivalencia, es_exempt, es_inversion_sujeto_pasivo, es_non_taxable, es_non_taxable_localization, eu_oss, eu_b2b, eu_b2b_services, export, other.","example":"vat","isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].tax_items.items.[INDEX].type","typeLabel":"string"},"rate":{"type":"number","description":"Tax rate as a percentage. For example 21 means 21%, and 10.5 means 10.5%. Zero for exempt or non-taxable lines.","example":21,"isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].tax_items.items.[INDEX].rate","typeLabel":"number"},"amount":{"type":"integer","description":"Tax charged for this line, in minor units (cents) of the invoice currency.","example":1743,"isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].tax_items.items.[INDEX].amount","typeLabel":"integer"}},"required":["name","type","rate","amount"],"additionalProperties":false,"description":"A single tax applied to an invoice line.","uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].tax_items.items.[INDEX]","typeLabel":"object"},"description":"The taxes applied to this line, broken down by category.","isRequired":true,"uniqueKey":"data.items.[INDEX].line_items.items.[INDEX].tax_items","typeLabel":"object[]"}},"required":["id","description","sku","quantity","unit_amount","subtotal","tax","total","tax_items"],"additionalProperties":false,"description":"A single line on an invoice.","uniqueKey":"data.items.[INDEX].line_items.items.[INDEX]","typeLabel":"object"},"description":"The lines that make up the invoice.","isRequired":true,"uniqueKey":"data.items.[INDEX].line_items","typeLabel":"object[]"},"kind":{"type":"string","description":"Whether this is an original invoice, a rectifying (corrective) one and by which method, or an exchange invoice. `rectifying_differences` corrects by the delta; `rectifying_substitution` replaces the original in full; `exchange` is the complete invoice issued in exchange for one or more correct simplified invoices (AEAT type F3), which stay valid and are not corrected. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: original, rectifying_differences, rectifying_substitution, exchange.","example":"original","isRequired":true,"uniqueKey":"data.items.[INDEX].kind","typeLabel":"string"},"rectifies":{"type":"array","items":{"oneOf":[{"type":"object","description":"An invoice a rectificativa corrects: either a local invoice (`{ invoice_id }`) or an external original (`{ external: { number, issued_on } }`).","required":["invoice_id"],"properties":{"invoice_id":{"type":"string","description":"Opaque, prefixed identifier of the referenced invoice.","example":"inv_clx123abc456","isRequired":true,"uniqueKey":"data.items.[INDEX].rectifies.items.[INDEX].oneOf.0.invoice_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.items.[INDEX].rectifies.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"An invoice a rectificativa corrects: either a local invoice (`{ invoice_id }`) or an external original (`{ external: { number, issued_on } }`).","required":["external"],"properties":{"external":{"type":"object","properties":{"number":{"type":"string","description":"Invoice number of the external original, as recorded.","example":"F-2025-091","isRequired":true,"uniqueKey":"data.items.[INDEX].rectifies.items.[INDEX].oneOf.1.external.number","typeLabel":"string"},"issued_on":{"type":"string","description":"Issue date of the external original, as a plain calendar date (YYYY-MM-DD).","example":"2025-03-14","isRequired":true,"uniqueKey":"data.items.[INDEX].rectifies.items.[INDEX].oneOf.1.external.issued_on","typeLabel":"string"}},"required":["number","issued_on"],"additionalProperties":false,"description":"The external original this invoice rectifies, identified by its number and issue date because it was not issued through Finseed.","isRequired":true,"uniqueKey":"data.items.[INDEX].rectifies.items.[INDEX].oneOf.1.external","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.items.[INDEX].rectifies.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"data.items.[INDEX].rectifies.items.[INDEX]","typeLabel":"object"},"description":"The invoices this invoice rectifies. Empty for originals. A rectificativa issued against invoices in Finseed carries one `{ invoice_id }` entry per corrected invoice; one issued against an external original carries a single `{ external: { number, issued_on } }` entry.","isRequired":true,"uniqueKey":"data.items.[INDEX].rectifies","typeLabel":"object[]"},"rectified_by":{"type":"array","items":{"type":"object","properties":{"invoice_id":{"type":"string","description":"Opaque, prefixed identifier of the referenced invoice.","example":"inv_clx123abc456","isRequired":true,"uniqueKey":"data.items.[INDEX].rectified_by.items.[INDEX].invoice_id","typeLabel":"string"}},"required":["invoice_id"],"additionalProperties":false,"description":"A reference to another invoice by its opaque id.","uniqueKey":"data.items.[INDEX].rectified_by.items.[INDEX]","typeLabel":"object"},"description":"The rectifying invoices that correct this invoice, one `{ invoice_id }` entry each. Empty when nothing rectifies it. Voided rectificativas are excluded.","isRequired":true,"uniqueKey":"data.items.[INDEX].rectified_by","typeLabel":"object[]"}},"required":["id","status","number","currency","subtotal","tax","total","recipient_name","recipient_tax_id","email","external_customer_id","external_id","invoice_date","operation_date","created_at","type","number_series_id","recipient","pdf_url","issuing_system","verifactu","line_items","kind","rectifies","rectified_by"],"additionalProperties":false,"description":"A tax invoice as exposed by the public API.","example":{"id":"inv_clx123abc456","status":"issued","number":"2026-000123","currency":"eur","subtotal":8300,"tax":1743,"total":10043,"recipient_name":"ACME, S.L.","recipient_tax_id":"B12345678","email":"[email protected]","external_customer_id":"cus_9aZ","external_id":"order-84312","invoice_date":"2026-06-01T09:30:00Z","operation_date":"2026-06-01T09:30:00Z","created_at":"2026-06-01T09:30:00Z","type":"complete","number_series_id":"ns_clx456def789","recipient":{"name":"ACME, S.L.","company_name":null,"tax_id":"B12345678","tax_id_type":"es_nif","tax_id_country":"ES","email":"[email protected]","address":{"line1":"Calle Mayor 1","line2":null,"postal_code":"28001","city":"Madrid","country":"ES"}},"pdf_url":"https://api.finseed.es/v1/invoices/inv_clx123abc456/file?token=abc","issuing_system":"verifactu","verifactu":{"status":"registered","hash":"B11F3A0151ADA655A9A0A4A64F32F440BE0EE0F5A695BB2E4DC5C0C0AF6E8D2A","qr_url":"https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?nif=B12345678\u0026numserie=2026-000123\u0026fecha=01-06-2026\u0026importe=100.43","error":null},"line_items":[{"id":"ili_clx789def012","description":"Consulting services","sku":"SVC-01","quantity":2,"unit_amount":4150,"subtotal":8300,"tax":1743,"total":10043,"tax_items":[{"name":"IVA 21%","type":"vat","rate":21,"amount":1743}]}],"kind":"original","rectifies":[],"rectified_by":[]},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"has_more":{"type":"boolean","description":"Whether more invoices exist beyond this page.","example":true,"isRequired":true,"uniqueKey":"has_more","typeLabel":"boolean"},"next_cursor":{"oneOf":[{"type":"string","description":"Cursor to pass back as starting_after for the next page, or null on the last page.","example":"inv_clx123abc456","isRequired":true,"uniqueKey":"next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"Cursor to pass back as starting_after for the next page, or null on the last page.","example":"inv_clx123abc456","isRequired":true,"uniqueKey":"next_cursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_cursor","typeLabel":"string | null"},"next_url":{"oneOf":[{"type":"string","description":"Relative path to the next page, preserving the current filters, or null on the last page.","example":"/v1/invoices?limit=25\u0026starting_after=inv_clx123abc456","isRequired":true,"uniqueKey":"next_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Relative path to the next page, preserving the current filters, or null on the last page.","example":"/v1/invoices?limit=25\u0026starting_after=inv_clx123abc456","isRequired":true,"uniqueKey":"next_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_url","typeLabel":"string | null"}},"required":["data","has_more","next_cursor","next_url"],"additionalProperties":false,"description":"A cursor-paginated page of invoices.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"inv_clx123abc456","status":"issued","number":"2026-000123","currency":"eur","subtotal":8300,"tax":1743,"total":10043,"recipient_name":"ACME, S.L.","recipient_tax_id":"B12345678","email":"[email protected]","external_customer_id":"cus_9aZ","external_id":"order-84312","invoice_date":"2026-06-01T09:30:00Z","operation_date":"2026-06-01T09:30:00Z","created_at":"2026-06-01T09:30:00Z","type":"complete","number_series_id":"ns_clx456def789","recipient":{"name":"ACME, S.L.","company_name":null,"tax_id":"B12345678","tax_id_type":"es_nif","tax_id_country":"ES","email":"[email protected]","address":{"line1":"Calle Mayor 1","line2":null,"postal_code":"28001","city":"Madrid","country":"ES"}},"pdf_url":"https://api.finseed.es/v1/invoices/inv_clx123abc456/file?token=abc","issuing_system":"verifactu","verifactu":{"status":"registered","hash":"B11F3A0151ADA655A9A0A4A64F32F440BE0EE0F5A695BB2E4DC5C0C0AF6E8D2A","qr_url":"https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?nif=B12345678\u0026numserie=2026-000123\u0026fecha=01-06-2026\u0026importe=100.43","error":null},"line_items":[{"id":"ili_clx789def012","description":"Consulting services","sku":"SVC-01","quantity":2,"unit_amount":4150,"subtotal":8300,"tax":1743,"total":10043,"tax_items":[{"name":"IVA 21%","type":"vat","rate":21,"amount":1743}]}],"kind":"original","rectifies":[],"rectified_by":[]}],"has_more":true,"next_cursor":"inv_clx123abc456","next_url":"/v1/invoices?limit=25\u0026starting_after=inv_clx123abc456"}}},"exampleType":"generated"}},"exampleType":"generated"},"20b2dc83-6633-4151-8b7c-3093ea1cd37b":{"description":"The request was rejected during validation. The `errors` array lists each failing field with a reason, so you can map the failure back to a specific parameter.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable, machine-readable error code. The branch key. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: invalid_request, unauthorized, invoice_not_found, download_link_expired, number_series_not_found, number_series_prefix_taken, number_series_numbering_collision, number_series_in_use, customer_ambiguous, idempotency_conflict, external_id_already_used, rate_limited, invalid_number_series, invalid_tax_rate, invalid_tax_data, invalid_tax_id, tax_id_type_country_mismatch, insufficient_recipient_data, simplified_amount_exceeded, simplified_incompatible_tax_type, invalid_recargo_equivalencia, aeat_mandate_not_approved, no_active_subscription, tax_id_validation_unavailable, recipient_changed_during_validation, invalid_rectifies_reference, rectified_invoice_not_found, invoice_already_voided, invoice_already_replaced, invoice_not_family_tip, invoice_pending_at_aeat, invoice_not_rectifiable_at_aeat, family_balance_below_zero, replacement_total_negative, reason_incompatible_with_recipient, recipient_overrides_not_allowed_for_differences, rectifying_series_invalid, num_series_not_applicable_for_order_invoice, external_reference_invalid, external_reference_matches_existing_invoice, rectified_amounts_required_for_substitution, downgrade_to_simplified_not_allowed, upgrade_to_complete_not_allowed, invoice_has_live_canje, invoice_is_canje, internal_error.","example":"invalid_request","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable, context-specific explanation.","example":"The query parameters are not valid.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"Location of the offending value (JSON path).","example":"limit","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable validation issue code.","example":"too_big","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation of the field-level issue.","example":"Number must be less than or equal to 100","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Field-level issues. Always present; empty unless this is a validation failure.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"doc_url":{"type":"string","description":"Link to the reference documentation for this error code.","example":"https://www.finseed.es/docs/api-reference/errors#invalid_request","isRequired":true,"uniqueKey":"doc_url","typeLabel":"string"}},"required":["code","detail","errors","doc_url"],"additionalProperties":false,"description":"Uniform error body returned for every non-2xx response (application/json).","uniqueKey":"","typeLabel":"object"},"example":{"code":"invalid_request","detail":"The request is not valid. A parameter is missing, malformed, or out of range. See the `errors` array for the fields that failed.","errors":[],"doc_url":"https://www.finseed.es/docs/api-reference/errors#invalid_request"},"examples":{"Example":{"title":"Example","value":{"code":"invalid_request","detail":"The request is not valid. A parameter is missing, malformed, or out of range. See the `errors` array for the fields that failed.","errors":[],"doc_url":"https://www.finseed.es/docs/api-reference/errors#invalid_request"}}},"exampleType":"examples"}},"exampleType":"examples"},"e01d9000-8162-4a8a-b61d-eacce8d01470":{"description":"Authentication failed: the API key is missing, malformed, or revoked. Send a valid key as a bearer token in the `Authorization` header. Each key is bound to a single environment (test or live).","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable, machine-readable error code. The branch key. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: invalid_request, unauthorized, invoice_not_found, download_link_expired, number_series_not_found, number_series_prefix_taken, number_series_numbering_collision, number_series_in_use, customer_ambiguous, idempotency_conflict, external_id_already_used, rate_limited, invalid_number_series, invalid_tax_rate, invalid_tax_data, invalid_tax_id, tax_id_type_country_mismatch, insufficient_recipient_data, simplified_amount_exceeded, simplified_incompatible_tax_type, invalid_recargo_equivalencia, aeat_mandate_not_approved, no_active_subscription, tax_id_validation_unavailable, recipient_changed_during_validation, invalid_rectifies_reference, rectified_invoice_not_found, invoice_already_voided, invoice_already_replaced, invoice_not_family_tip, invoice_pending_at_aeat, invoice_not_rectifiable_at_aeat, family_balance_below_zero, replacement_total_negative, reason_incompatible_with_recipient, recipient_overrides_not_allowed_for_differences, rectifying_series_invalid, num_series_not_applicable_for_order_invoice, external_reference_invalid, external_reference_matches_existing_invoice, rectified_amounts_required_for_substitution, downgrade_to_simplified_not_allowed, upgrade_to_complete_not_allowed, invoice_has_live_canje, invoice_is_canje, internal_error.","example":"invalid_request","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable, context-specific explanation.","example":"The query parameters are not valid.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"Location of the offending value (JSON path).","example":"limit","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable validation issue code.","example":"too_big","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation of the field-level issue.","example":"Number must be less than or equal to 100","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Field-level issues. Always present; empty unless this is a validation failure.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"doc_url":{"type":"string","description":"Link to the reference documentation for this error code.","example":"https://www.finseed.es/docs/api-reference/errors#invalid_request","isRequired":true,"uniqueKey":"doc_url","typeLabel":"string"}},"required":["code","detail","errors","doc_url"],"additionalProperties":false,"description":"Uniform error body returned for every non-2xx response (application/json).","uniqueKey":"","typeLabel":"object"},"example":{"code":"unauthorized","detail":"Authentication failed. Send your API key as a bearer token in the `Authorization` header. Keys are scoped to one environment, so a test key cannot read live data and vice versa.","errors":[],"doc_url":"https://www.finseed.es/docs/api-reference/errors#unauthorized"},"examples":{"Example":{"title":"Example","value":{"code":"unauthorized","detail":"Authentication failed. Send your API key as a bearer token in the `Authorization` header. Keys are scoped to one environment, so a test key cannot read live data and vice versa.","errors":[],"doc_url":"https://www.finseed.es/docs/api-reference/errors#unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"78897dac-8807-4eac-abc0-228f6e66df82":{"description":"An unexpected error occurred on our side. No partial work is persisted, so the request can be retried safely.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Stable, machine-readable error code. The branch key. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: invalid_request, unauthorized, invoice_not_found, download_link_expired, number_series_not_found, number_series_prefix_taken, number_series_numbering_collision, number_series_in_use, customer_ambiguous, idempotency_conflict, external_id_already_used, rate_limited, invalid_number_series, invalid_tax_rate, invalid_tax_data, invalid_tax_id, tax_id_type_country_mismatch, insufficient_recipient_data, simplified_amount_exceeded, simplified_incompatible_tax_type, invalid_recargo_equivalencia, aeat_mandate_not_approved, no_active_subscription, tax_id_validation_unavailable, recipient_changed_during_validation, invalid_rectifies_reference, rectified_invoice_not_found, invoice_already_voided, invoice_already_replaced, invoice_not_family_tip, invoice_pending_at_aeat, invoice_not_rectifiable_at_aeat, family_balance_below_zero, replacement_total_negative, reason_incompatible_with_recipient, recipient_overrides_not_allowed_for_differences, rectifying_series_invalid, num_series_not_applicable_for_order_invoice, external_reference_invalid, external_reference_matches_existing_invoice, rectified_amounts_required_for_substitution, downgrade_to_simplified_not_allowed, upgrade_to_complete_not_allowed, invoice_has_live_canje, invoice_is_canje, internal_error.","example":"invalid_request","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable, context-specific explanation.","example":"The query parameters are not valid.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"Location of the offending value (JSON path).","example":"limit","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable validation issue code.","example":"too_big","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation of the field-level issue.","example":"Number must be less than or equal to 100","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"additionalProperties":false,"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Field-level issues. Always present; empty unless this is a validation failure.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"doc_url":{"type":"string","description":"Link to the reference documentation for this error code.","example":"https://www.finseed.es/docs/api-reference/errors#invalid_request","isRequired":true,"uniqueKey":"doc_url","typeLabel":"string"}},"required":["code","detail","errors","doc_url"],"additionalProperties":false,"description":"Uniform error body returned for every non-2xx response (application/json).","uniqueKey":"","typeLabel":"object"},"example":{"code":"internal_error","detail":"Something went wrong on our side. The request did not complete and can be retried safely.","errors":[],"doc_url":"https://www.finseed.es/docs/api-reference/errors#internal_error"},"examples":{"Example":{"title":"Example","value":{"code":"internal_error","detail":"Something went wrong on our side. The request did not complete and can be retried safely.","errors":[],"doc_url":"https://www.finseed.es/docs/api-reference/errors#internal_error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"43ad838b-f198-487f-9ceb-ed827457cefe":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key sent as a bearer token in the `Authorization` header.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"fcd86d28-6eaf-472b-9e4a-903bb52993a9":{"url":"https://api.finseed.es"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key sent as a bearer token in the `Authorization` header.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key sent as a bearer token in the `Authorization` header.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"easyverifactu-docs","siteName":"Finseed","title":"List invoices - Finseed","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T11:31:29.531Z","originalFileLocation":"api-reference/invoices/list-invoices.mdx","locale":"es"},"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=\"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow next_url to page through the rest.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Finseed\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List invoices - Finseed\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow next_url to page through the rest.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Finseed\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.finseed.es/docs/api-reference/invoices/list-invoices\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://easyverifactu-docs.mintlify.app/_mintlify/api/og/v2?division=Invoices\u0026amp;title=List+invoices\u0026amp;description=Returns+a+cursor-paginated+list+of+invoices+for+the+environment+the+API+key+belongs+to%2C+most+recent+first.+Use+the+optional+filters+to+narrow+the+result%2C+and+fo\u0026amp;theme=1bd31d7d749ca54a50bbb3ea\u0026amp;signature=ec2b9eb22b74882055d05368dfff73b3343d014012f77ecb21d58342f7001359\">\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 - Finseed\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow next_url to page through the rest.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://easyverifactu-docs.mintlify.app/_mintlify/api/og/v2?division=Invoices\u0026amp;title=List+invoices\u0026amp;description=Returns+a+cursor-paginated+list+of+invoices+for+the+environment+the+API+key+belongs+to%2C+most+recent+first.+Use+the+optional+filters+to+narrow+the+result%2C+and+fo\u0026amp;theme=1bd31d7d749ca54a50bbb3ea\u0026amp;signature=ec2b9eb22b74882055d05368dfff73b3343d014012f77ecb21d58342f7001359\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/easyverifactu-docs/II4gsUynwX8KPRvY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Finseed\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003cmeta data-mint-head name=\"og:locale\" content=\"es_ES\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.finseed.es/docs/api-reference/invoices/list-invoices\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/invoices/list-invoices.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.finseed.es/#organization\",\"name\":\"Finseed\",\"url\":\"https://www.finseed.es\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/easyverifactu-docs/eHxJd3kRdehy8fGT/logo/finseed-logo.svg?fit=max\u0026auto=format\u0026n=eHxJd3kRdehy8fGT\u0026q=85\u0026s=da8e7a9fc54301ce10ead986bbe819b0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.finseed.es/docs#website\",\"name\":\"Finseed\",\"url\":\"https://www.finseed.es/docs\",\"publisher\":{\"@id\":\"https://www.finseed.es/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.finseed.es/docs/api-reference/invoices/list-invoices#webpage\",\"url\":\"https://www.finseed.es/docs/api-reference/invoices/list-invoices\",\"name\":\"List invoices\",\"description\":\"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow next_url to page through the rest.\",\"dateModified\":\"2026-10-27T11:31:29.531Z\",\"isPartOf\":{\"@id\":\"https://www.finseed.es/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.finseed.es/docs/api-reference/invoices/list-invoices#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.finseed.es/docs/api-reference/invoices/list-invoices#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Invoices\",\"item\":\"https://www.finseed.es/docs/api-reference/creating-invoices\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List invoices\",\"item\":\"https://www.finseed.es/docs/api-reference/invoices/list-invoices\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.finseed.es/docs/api-reference/invoices/list-invoices#apireference\",\"headline\":\"List invoices\",\"name\":\"List invoices\",\"description\":\"Returns a cursor-paginated list of invoices for the environment the API key belongs to, most recent first. Use the optional filters to narrow the result, and follow next_url to page through the rest.\",\"url\":\"https://www.finseed.es/docs/api-reference/invoices/list-invoices\",\"mainEntityOfPage\":{\"@id\":\"https://www.finseed.es/docs/api-reference/invoices/list-invoices#webpage\"},\"dateModified\":\"2026-10-27T11:31:29.531Z\",\"publisher\":{\"@id\":\"https://www.finseed.es/#organization\"},\"isPartOf\":{\"@id\":\"https://www.finseed.es/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Finseed\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Finseed","nav":{"global":{"languages":[{"language":"es","default":true,"hidden":false,"href":"https://www.finseed.es/docs"}]},"tabs":[{"tab":"Inicio","pages":[{"title":"Inicio","href":""}]},{"tab":"Shopify","pages":[{"title":"Shopify","href":"/shopify/como-funciona"}]},{"tab":"Stripe","pages":[{"title":"Stripe","href":"/stripe/como-funciona"}]},{"tab":"PrestaShop","pages":[{"title":"PrestaShop","href":"/prestashop/como-funciona"}]},{"tab":"WooCommerce","pages":[{"title":"WooCommerce","href":"/woocommerce/como-funciona"}]},{"tab":"API Reference","hidden":false,"groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Idempotency","href":"/api-reference/idempotency"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Invoices","pages":[{"title":"Create an invoice","openapi":"POST /v1/invoices","href":"/api-reference/creating-invoices"},{"title":"Create a rectifying invoice","openapi":"POST /v1/invoices","href":"/api-reference/creating-rectifying-invoices"},{"title":"Validate an invoice payload","description":"Dry-runs an invoice creation payload through the exact validations the create endpoint applies, including the register check the recipient tax id gets when it is a Spanish NIF or an EU VAT number, without persisting anything. Failures return the same errors the create endpoint would; success returns the totals the invoice would carry. A passing validation does not reserve an invoice number and cannot fully guarantee the subsequent creation.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/invoices/validate","href":"/api-reference/invoices/validate-an-invoice-payload"},{"title":"List invoices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Retrieve an invoice","description":"Returns a single invoice by id, in the same shape as each row of the list endpoint. The invoice must belong to the environment the API key belongs to, otherwise the response is a 404.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/invoices/{id}","href":"/api-reference/invoices/retrieve-an-invoice"},{"title":"Download an invoice PDF","openapi":"GET /v1/invoices/{id}/download","href":"/api-reference/download-invoice"}]},{"group":"Number Series","pages":[{"title":"Create a number series","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/number_series","href":"/api-reference/number-series/create-a-number-series"},{"title":"List number series","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/number_series","href":"/api-reference/number-series/list-number-series"},{"title":"Retrieve a number series","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/number_series/{id}","href":"/api-reference/number-series/retrieve-a-number-series"},{"title":"Delete a number series","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/number_series/{id}","href":"/api-reference/number-series/delete-a-number-series"}]},{"group":"Tax IDs","pages":[{"title":"Validate a tax id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tax_ids/validate","href":"/api-reference/tax-ids/validate-a-tax-id"}]},{"group":"Customer portal","pages":[{"title":"Create a customer portal session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/customer_portal/sessions","href":"/api-reference/customer-portal/create-a-customer-portal-session"}]}]}]},"basePath":"","title":"List invoices - Finseed","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CLz2_Z5D.js","utils-7A5jZhOT.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BVWmkKuv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-4SOfrh0F.js","snippetPresets-CMc8KicP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ba9tX7z3.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Be8krXvv.js","shallow-CBC3K1uB.js","getApiPlaygroundDisplay-4tKcUAYo.js","CodeSnippet-C1Xa06ft.js","CodeSnippets-vqiz27A_.js","Page-DeQN5MDd.js","getPastedJson-NUwRfM32.js","icon-DkIVqWh9.js","MethodPill-qmhT7_wz.js","DuplicateIcon-_gWp1vhn.js","createIcon-NA1p_TVA.js","DynamicMarkdown-Bas9A7wq.js","SectionHeading-a1cS-24U.js","axios-vUo_bRtp.js","Markdown-D3ZTwq_a.js","clsx-BcghKhHb.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B66mVNPp.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DmooSyTN.js"]}