> ## Documentation Index > Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt > Use this file to discover all available pages before exploring further. # List invoices > Returns a paginated list of the invoices of the fiscal link associated with the `link_token`, sorted by descending document date. For links created with the `invoices` product, Fintoc returns every document the fiscal authority reports. For links created with the `income` product, Fintoc returns only the fee receipts for professional services the account holder issued. **`v1`** · Base URL `https://api.fintoc.com/v1` ## OpenAPI ````yaml reference/fintoc-api.json GET /invoices openapi: 3.1.0 info: title: fintoc-api version: v2026-02-01 servers: - url: https://api.fintoc.com/v1 security: [] paths: /invoices: get: tags: - Invoices summary: List invoices description: >- Returns a paginated list of the invoices of the fiscal link associated with the `link_token`, sorted by descending document date. For links created with the `invoices` product, Fintoc returns every document the fiscal authority reports. For links created with the `income` product, Fintoc returns only the fee receipts for professional services the account holder issued. operationId: invoices-list parameters: - name: link_token in: query required: true schema: type: string example: link_6n12zLmai3lLE9Dq_token_gvEJi8FrBge4fb3cz7Wp856W description: >- Access token of the fiscal link that holds the invoices, returned when the link is created. - name: since in: query required: false schema: type: string format: date example: '2021-01-01' description: >- ISO 8601 date. If present, Fintoc returns only invoices with `date` on or after this value. - name: until in: query required: false schema: type: string format: date example: '2021-01-31' description: >- ISO 8601 date. If present, Fintoc returns only invoices with `date` on or before this value. - name: updated_since in: query required: false schema: type: string format: date-time example: '2021-01-01T00:00:00.000Z' description: >- ISO 8601 datetime. If present, Fintoc returns invoices updated on or after the earlier of this value and the last successful invoices refresh timestamp. If the account has not been refreshed yet, this filter does not narrow the result set. - name: issue_type in: query required: false schema: type: string enum: - issued - received example: issued description: >- If present, Fintoc returns only invoices with this issue type. One of `issued` (sales documents) or `received` (purchase documents). - name: invoice_status in: query required: false schema: type: string enum: - registered - pending example: registered description: >- If present, Fintoc returns only invoices with this status. One of `registered` (appears in the official registry) or `pending` (awaits acknowledgment from the receiver). - name: page in: query required: false schema: type: integer format: int32 description: Page number to retrieve, starting at `1`. Defaults to `1`. - name: per_page in: query required: false schema: type: integer format: int32 description: Number of invoices per page. Defaults to `30`. The maximum is `300`. responses: '200': description: >- Paginated list of invoices, sorted by descending document date. The `Link` and `X-Total-Count` headers carry the pagination information. headers: Link: schema: type: string X-Total-Count: schema: type: integer content: application/json: examples: invoices_list: value: - id: inv_9qXbVNDzgrXyq2Oa object: invoice currency: CLP date: '2021-05-12T00:00:00.000Z' institution_id: cl_fiscal_sii institution_invoice: accepted_at: '2021-05-13T11:23:09.000Z' common_use_vat: 0 confirmation_status: A construction_company_credit: 0 container_deposit_guarantee: 0 document_type: 33 domestic_ticket_sales: 0 exempt_amount: 0 exempt_commissions: 0 fixed_assets_net_amount: 0 fixed_assets_vat_amount: 0 free_zone_tax: 0 has_note: false international_ticket_sales: 0 invoice_status: registered is_services_invoice: false net_commissions: 0 non_credit_tax_amount: 0 non_refundable_vat_amount: 0 non_refundable_vat_code: 0 non_withheld_vat: 0 other_taxes: {} out_of_time_vat: 0 own_vat: 0 partial_vat_withheld: 0 receipt_reference_number: null received_at: '2021-05-12T09:31:02.000Z' reference_number: '1044' reference_type_code: 33 rejected_at: null services_invoice: null settlement_issuer_id: 76123456-7 third_party_vat: 0 tobacco: {} total_documents: null total_vat_withheld: 0 transaction_category: Del Giro vat_amount: 19000 vat_commissions: 0 issue_type: received issuer: id: 76123456-7 name: Proveedor SpA net_amount: 100000 number: '2611' receiver: null tax_period: 05/2021 total_amount: 119000 schema: type: array items: $ref: '#/components/schemas/invoice' '400': description: >- Invalid request: the `link_token` is empty, or a filter has an invalid value. content: application/json: examples: empty_link_token: value: error: type: invalid_request_error code: empty_string param: link_token message: 'Empty string is invalid: link_token' doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' '403': description: >- The `link_token` does not correspond to a link of your organization for the mode of the API key used. content: application/json: examples: invalid_link_token: value: error: type: invalid_request_error code: invalid_link_token param: link_token message: >- Invalid access token for link: link_6n12zLmai3lLE9Dq_token_********************856W doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: invoice: type: object properties: id: type: string description: Unique identifier of the invoice. example: inv_9qXbVNDzgrXyq2Oa object: const: invoice description: Type of the object. Always `invoice`. currency: type: - string - 'null' description: >- Three-letter ISO 4217 currency code of the document amounts, in uppercase. `null` when the fiscal authority does not report it. example: CLP date: type: - string - 'null' format: date-time description: >- ISO 8601 timestamp of the document date. For grouped summary entries, corresponds to the last day of the tax period each entry covers. example: '2021-05-12T00:00:00.000Z' institution_id: type: string enum: - cl_fiscal_sii - mx_fiscal_sat description: >- Identifier of the fiscal authority that reported the invoice. One of `cl_fiscal_sii` (Chilean tax authority, SII) or `mx_fiscal_sat` (Mexican tax authority, SAT). example: cl_fiscal_sii institution_invoice: description: >- Detail specific to the fiscal authority that reported the invoice: a `sii_invoice` for SII invoices or a `sat_invoice` for SAT invoices. oneOf: - $ref: '#/components/schemas/sat_invoice' - $ref: '#/components/schemas/sii_invoice' issue_type: type: string enum: - issued - received description: >- Whether the account holder issued or received the document. One of `issued` (sales documents) or `received` (purchase documents). example: received issuer: type: - object - 'null' description: >- Party that issued the document. `null` when the account holder issued the document or when the entry is a grouped summary. properties: id: type: - string - 'null' description: >- Tax identifier of the issuer: a Chilean tax ID (RUT) for SII invoices or a Mexican tax ID (RFC) for SAT invoices. `null` when the fiscal authority does not report it. example: 76123456-7 name: type: - string - 'null' description: Name of the issuer. example: Proveedor SpA net_amount: type: - integer - 'null' description: >- Net amount of the document, in the smallest unit of `currency` (for example, `1000` for $1000 CLP, since CLP has no minor unit, or `1000` for $10.00 MXN). example: 100000 number: type: - string - 'null' description: >- Number of the document in the fiscal authority's registry, for example the folio of an SII document. `null` when the registry does not report a number. example: '2611' receiver: type: - object - 'null' description: >- Party that received the document. `null` when the account holder received the document or when the entry is a grouped summary. properties: id: type: - string - 'null' description: >- Tax identifier of the receiver: a Chilean tax ID (RUT) for SII invoices or a Mexican tax ID (RFC) for SAT invoices. `null` when the fiscal authority does not report it. example: 77654321-0 name: type: - string - 'null' description: Name of the receiver. example: Comercial Andes Ltda. tax_period: type: - string - 'null' description: Tax period the document belongs to, in `MM/YYYY` format. example: 05/2021 total_amount: type: - integer - 'null' description: >- Total amount of the document, including taxes, in the smallest unit of `currency` (for example, `1000` for $1000 CLP, since CLP has no minor unit, or `1000` for $10.00 MXN). example: 119000 required: - id - object - currency - date - institution_id - institution_invoice - issue_type - issuer - net_amount - number - receiver - tax_period - total_amount error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_api_key`. Not returned by every error. example: invalid_api_key doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Invalid API Key: invalid-*oken' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. `null` when the error cannot be tied to a single parameter, and not returned by every error. example: amount type: type: string description: >- Category of the error, for example `invalid_request_error`, `authentication_error`, or `api_error`. example: invalid_request_error required: - type - message sat_invoice: type: object properties: cancelation: type: - object - 'null' description: >- Cancelation detail of the document in the registry of the Mexican tax authority (SAT). `null` when the document has not been canceled. properties: canceled_at: type: string format: date-time description: ISO 8601 timestamp of when the document was canceled. example: '2021-06-02T15:21:04.000Z' process_status: type: string description: >- Status of the cancelation process, for example `Cancelado sin aceptación`. example: Cancelado sin aceptación status: type: string description: >- Cancelability status of the document, for example `Cancelable sin aceptación`. example: Cancelable sin aceptación certified_at: type: - string - 'null' format: date-time description: >- ISO 8601 timestamp of when an authorized certification provider (PAC) certified the document. example: '2021-05-12T09:31:02.000Z' cfdi_usage: type: - string - 'null' description: >- Usage the receiver declares for the digital tax document (CFDI), as a code from the SAT `UsoCFDI` catalog, for example `G03` for general expenses. example: G03 cfdi_version: type: - string - 'null' description: Version of the CFDI standard the document follows. example: '3.3' exchange_rate: type: - string - 'null' description: >- Exchange rate between the document currency and Mexican pesos (MXN) at issuance. `1.0` when the document currency is MXN. example: '1.0' exempt_amount: type: - integer - 'null' description: >- Tax-exempt amount of the document, in the smallest unit of the document currency (centavos for MXN). internal_id: type: - string - 'null' description: Folio the issuer assigns to the document for internal control. example: '12345' items: type: - array - 'null' description: Line items ('conceptos') of the document. items: type: object properties: id: type: string description: Identifier of the line item within the document. description: type: string description: Description of the good or service. example: Product 1 product_id: type: string description: >- Code of the good or service in the SAT product and service catalog. quantity: type: string description: Quantity of the good or service covered by the line item. example: '1' taxes: type: array description: Taxes that apply to the line item. items: type: object properties: amount: type: integer description: >- Amount of the tax, in the smallest unit of the document currency. code: type: string description: >- Code of the tax in the SAT tax catalog, for example `002` for value-added tax (IVA). example: '002' factor: type: object description: Factor the tax applies to the base amount. properties: amount: type: string description: Rate or fixed amount of the factor. example: '0.16' type: type: string description: >- How the factor is applied, for example as a rate over the base amount. type: type: string description: Whether the document transfers or withholds the tax. total_amount: type: integer description: >- Total amount of the line item, in the smallest unit of the document currency. unit_amount: type: integer description: >- Unit price of the good or service, in the smallest unit of the document currency. unit_code: type: string description: >- Code of the unit of measure in the SAT unit catalog, for example `ACT` for an activity. example: ACT pac_id: type: - string - 'null' description: Identifier of the PAC that certified the document. example: '12345' payment_method_code: type: - string - 'null' description: >- Code of the payment form from the SAT `FormaPago` catalog, for example `01` for cash or `03` for electronic transfer. `null` when the document does not declare it. example: '03' payment_type: type: - string - 'null' description: >- Payment method declared in the document, from the SAT `MetodoPago` catalog. postal_code: type: - string - 'null' description: Postal code of the place where the document was issued. example: '06600' status: type: string description: >- Validity status of the document in the SAT registry. `valid` while the document is in force and `canceled` after the SAT cancels it. example: valid voucher_type: type: string description: >- Type of the document according to the SAT `TipoDeComprobante` catalog, for example `incoming` for an income document ('ingreso'). example: incoming required: - cancelation - certified_at - cfdi_usage - cfdi_version - exchange_rate - exempt_amount - internal_id - items - pac_id - payment_method_code - payment_type - postal_code - status - voucher_type sii_invoice: type: object properties: accepted_at: type: - string - 'null' format: date-time description: >- ISO 8601 timestamp of when the receiver accepted the document in the registry of the Chilean tax authority (SII). `null` when the document has not been accepted. example: '2021-05-13T11:23:09.000Z' common_use_vat: type: - integer - 'null' description: >- Value-added tax (VAT) on purchases used for both taxable and exempt operations ('IVA uso común'), in Chilean pesos (CLP). confirmation_status: type: - string - 'null' enum: - P - A - C - R - G - null description: >- Result of the SII acceptance or claim process for received documents. One of `P` (cash payment document, no acknowledgment needed), `A` (acknowledged automatically after the legal term lapsed without a claim), `C` (acknowledged by the receiver within the legal term), `R` (claimed by the receiver), or `G` (acknowledged through dispatch guides of the previous month). `null` when the SII reports no confirmation process, for example on issued documents. example: A construction_company_credit: type: - integer - 'null' description: >- Special tax credit for construction companies, in CLP. `null` when the SII does not report it. container_deposit_guarantee: type: - integer - 'null' description: >- Deposit guarantee for returnable containers, in CLP. `null` when the SII does not report it. document_type: type: - integer - 'null' description: >- Code of the electronic tax document type (DTE) as defined by the SII, for example `33` for an electronic invoice. `null` when the document is a fee receipt for professional services ('boleta de honorarios'). example: 33 domestic_ticket_sales: type: - integer - 'null' description: >- Amount of domestic passenger ticket sales, in CLP. `null` when the SII does not report it. exempt_amount: type: - integer - 'null' description: VAT-exempt amount of the document, in CLP. exempt_commissions: type: - integer - 'null' description: >- VAT-exempt commissions of a settlement invoice ('liquidación factura'), in CLP. fixed_assets_net_amount: type: - integer - 'null' description: Net amount of the fixed assets purchased with the document, in CLP. fixed_assets_vat_amount: type: - integer - 'null' description: VAT on the fixed assets purchased with the document, in CLP. free_zone_tax: type: - integer - 'null' description: >- Free-zone tax of the document, in CLP. `null` when the SII does not report it. has_note: type: - boolean - 'null' description: Whether a credit or debit note references the document. international_ticket_sales: type: - integer - 'null' description: >- Amount of international passenger ticket sales, in CLP. `null` when the SII does not report it. invoice_status: type: - string - 'null' enum: - registered - pending - null description: >- Status of the document in the SII purchase and sales registry. One of `registered` (the document appears in the official registry) or `pending` (the document awaits acknowledgment from the receiver). example: registered is_services_invoice: type: - boolean - 'null' description: Whether the document is a fee receipt for professional services. net_commissions: type: - integer - 'null' description: >- Net amount of the commissions of a settlement invoice ('liquidación factura'), in CLP. `null` when the SII does not report it. non_credit_tax_amount: type: - integer - 'null' description: Amount of taxes that give no right to a tax credit, in CLP. non_refundable_vat_amount: type: - integer - 'null' description: Non-recoverable VAT amount ('IVA no recuperable'), in CLP. non_refundable_vat_code: type: - integer - 'null' description: >- Code that states the reason why the VAT is not recoverable, as defined by the SII. non_withheld_vat: type: - integer - 'null' description: VAT amount not withheld by the receiver, in CLP. other_taxes: type: - object - 'null' additionalProperties: true description: Additional taxes of the document as reported by the SII. out_of_time_vat: type: - integer - 'null' description: >- VAT declared after the legal deadline ('IVA fuera de plazo'), in CLP. own_vat: type: - integer - 'null' description: >- VAT owed by the issuer on its own behalf in a settlement invoice ('IVA propio'), in CLP. partial_vat_withheld: type: - integer - 'null' description: VAT amount partially withheld by the receiver, in CLP. receipt_reference_number: type: - integer - 'null' description: >- Reference number of the receipt associated with the document. `null` when the registry does not report one. received_at: type: - string - 'null' format: date-time description: >- ISO 8601 timestamp of when the SII received the document. `null` when the SII does not report a reception date. example: '2021-05-12T09:31:02.000Z' reference_number: type: - string - 'null' description: >- Folio of the document this document references, for example the invoice that a credit note modifies. `null` when the document references no other document. example: '1044' reference_type_code: type: - integer - 'null' description: >- DTE type code of the referenced document. `null` when the document references no other document. example: 33 rejected_at: type: - string - 'null' format: date-time description: >- ISO 8601 timestamp of when the receiver claimed (rejected) the document. `null` when the document has not been claimed. services_invoice: type: - object - 'null' description: >- Detail of a fee receipt for professional services. `null` when `is_services_invoice` is `false`. properties: is_professional_society: type: - boolean - 'null' description: Whether a professional society issued the fee receipt. is_third_party: type: - boolean - 'null' description: >- Whether the holder issued the fee receipt on behalf of a third party. issued_at: type: - string - 'null' format: date-time description: ISO 8601 timestamp of when the fee receipt was issued. issuer_withheld_amount: type: - integer - 'null' description: Provisional tax the issuer withheld, in CLP. receiver_withheld_amount: type: - integer - 'null' description: Provisional tax the receiver withheld, in CLP. status: type: - string - 'null' description: Status of the fee receipt in the SII registry. settlement_issuer_id: type: - string - 'null' description: >- Chilean tax ID (RUT) of the issuer of a settlement invoice ('liquidación factura'). `null` when the document is not a settlement invoice. example: 76123456-7 third_party_vat: type: - integer - 'null' description: >- VAT owed on behalf of third parties in a settlement invoice ('IVA terceros'), in CLP. tobacco: type: - object - 'null' additionalProperties: true description: Tobacco taxes of the document, in CLP, as reported by the SII. total_documents: type: - integer - 'null' description: >- Number of documents that a grouped summary entry covers. `null` for individual documents. total_vat_withheld: type: - integer - 'null' description: Total VAT amount withheld by the receiver, in CLP. transaction_category: type: - string - 'null' description: >- Classification of the transaction in the SII registry, for example purchases of the taxpayer's line of business, supermarket purchases, or fixed-asset purchases. vat_amount: type: - integer - 'null' description: Recoverable VAT amount of the document, in CLP. example: 19000 vat_commissions: type: - integer - 'null' description: VAT on the commissions of a settlement invoice, in CLP. required: - accepted_at - common_use_vat - confirmation_status - construction_company_credit - container_deposit_guarantee - document_type - domestic_ticket_sales - exempt_amount - exempt_commissions - fixed_assets_net_amount - fixed_assets_vat_amount - free_zone_tax - has_note - international_ticket_sales - invoice_status - is_services_invoice - net_commissions - non_credit_tax_amount - non_refundable_vat_amount - non_refundable_vat_code - non_withheld_vat - other_taxes - out_of_time_vat - own_vat - partial_vat_withheld - receipt_reference_number - received_at - reference_number - reference_type_code - rejected_at - services_invoice - settlement_issuer_id - third_party_vat - tobacco - total_documents - total_vat_withheld - transaction_category - vat_amount - vat_commissions securitySchemes: api_key: type: apiKey name: Authorization in: header ````