> ## 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. # Get an invoice > Retrieves an invoice by its `id`, using the link's `link_token` to authenticate the request. You can only retrieve invoices that belong to the link's fiscal account. For links created with the `income` product, you can only retrieve the fee receipts for professional services the account holder issued. ## OpenAPI ````yaml reference/main-api.json GET /v1/invoices/{id} openapi: 3.1.0 info: title: fintoc-api version: v2026-02-01 servers: - url: https://api.fintoc.com security: [] paths: /v1/invoices/{id}: get: tags: - Invoices summary: Get an invoice description: >- Retrieves an invoice by its `id`, using the link's `link_token` to authenticate the request. You can only retrieve invoices that belong to the link's fiscal account. For links created with the `income` product, you can only retrieve the fee receipts for professional services the account holder issued. operationId: invoices-get parameters: - name: id in: path description: Unique identifier for the invoice to retrieve. required: true schema: type: string - 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 invoice, returned when the link is created. responses: '200': description: The invoice. content: application/json: examples: invoice: 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: 55555555-5 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: 55555555-5 name: Proveedor Test SpA net_amount: 100000 number: '2611' receiver: null tax_period: 05/2021 total_amount: 119000 schema: $ref: '#/components/schemas/invoice' '400': description: 'Invalid request: the `link_token` is missing or empty.' 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' '404': description: The invoice does not exist, or it is not visible to the link. content: application/json: examples: invoice_not_found: value: error: type: invalid_request_error code: missing_resource param: id message: 'No such invoice: inv_9qXbVNDzgrXyq2Oa' 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: 55555555-5 name: type: - string - 'null' description: Name of the issuer. example: Proveedor Test 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: 77777777-7 name: type: - string - 'null' description: Name of the receiver. example: Comercial Test 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: 55555555-5 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 ````