---
title: "Retrieve invoices for a link"
method: POST
path: "/api/cl/invoices/"
tags: ["Invoices Chile"]
---

# Retrieve invoices for a link

`POST /api/cl/invoices/`

Retrieve invoice information from a specific Chilean fiscal link.
You can ask for up to <b>one</b> year (365 days) of invoices per request. If you need invoices for more than one year, just make another request.
> 📘 Highly Recommended > > We strongly recommend that you use Belvo's `X-Belvo-Request-Mode` header parameter and implement an asynchronous workflow. This will ensure that you do not receive any timeout errors while retrieving invoice data.

## Query parameters

- `omit` string
- `fields` string

## Headers

- `X-Belvo-Request-Mode` 'async'

## Request body

- object
  - `link` string, uuid, required — The `link.id` you want to retrieve information for.
  - `date_from` string, date, required — The date from which you want to start getting data for, in `YYYY-MM-DD` format. ⚠️ The value of `date_from` cannot be greater than `date_to`.
  - `date_to` string, date, required — The date you want to stop getting data for, in `YYYY-MM-DD` format. ⚠️ The value of `date_to` cannot be greater than today's date (in other words, no future dates).
  - `type` 'OUTFLOW' | 'INFLOW' | 'null', nullable — The direction of the invoice (from the perspective of the Link owner). - `OUTFLOW` indicates a sent invoice. - `INFLOW` indicates a received invoice.
  - `save_data` boolean — Indicates whether or not to persist the data in Belvo. By default, this is set to `true` and we return a 201 Created response. When set to `false`, the data won't be persisted and we return a 200 OK response.

## Response `200`

Ok (when `save_data=false`)

- InvoiceChile[]
  - `id` string, uuid — Belvo's unique identifier for the current item.
  - `link` string, uuid, nullable — The `link.id` the data belongs to.
  - `created_at` string, date-time — The ISO-8601 timestamp of when the data point was created in Belvo's database.
  - `collected_at` string, date-time — The ISO-8601 timestamp when the data point was collected.
  - `total_amount` number, float — The total amount of the invoice, including VAT and other taxes or charges.
  - `net_amount` number, float — The total invoice amount after VAT and other taxes.
  - `vat_amount` number, float — The total VAT amount of the invoice.
  - `currency` string — The three-letter currency code (ISO-4217) of the invoice.
  - `issue_date` string, date — The date that the invoice was issued, in `YYYY-MM-DD` format.
  - `received_at` string, date-time — The ISO-8601 timestamp of when the invoice was received.
  - `acknowledged_at` string, date-time — The ISO-8601 timestamp of when the invoice was acknowledged as received.
  - `claim_date` string, date, nullable — The date when a claim or dispute was raised about the invoice, in `YYYY-MM-DD` format.
  - `status` string — The status of the invoice. Can be either: - `REGISTERED` - `PENDING` - `REJECTED` - `CANCELLED`
  - `document_code` integer — A code that indicates whether the document is a invoice, a credit or debit note, and so on.
  - `category` string — The category of the invoice, according to the institution.
  - `folio` string — The institution's unique code for the invoice.
  - `sender_id` string — The identification number of the sender. For SII Chile, this is the RUT.
  - `sender_name` string — The registered name of the sender.
  - `receiver_id` string — The identification number of the receiver. For SII Chile, this is the RUT.
  - `receiver_name` string — The registered name of the receiver.
  - `type` 'INFLOW' | 'OUTFLOW' — Indicates whether the invoice is an INFLOW or OUTFLOW.
  - `purchase_invoice_details` object, nullable — Details regarding the purchase invoice. If the invoice is a sales invoice (`type` = `OUTFLOW`), this field will return `null`.
    - `vat_refundable_amount` number, float, nullable — The amount of VAT paid that is eligible to be claimed back as a tax credit.
    - `vat_non_refundable_amount` number, float, nullable — The amount of VAT paid that cannot be claimed back as a tax credit.
    - `vat_non_refundable_code` integer, nullable — A code that identifies the reason why the VAT is not recoverable.
    - `net_amount_fixed_assets` number, float, nullable — The net value of the purchased fixed assets.
    - `vat_fixed_assets` number, float, nullable — The VAT value on the purchase of fixed assets.
    - `vat_common_use` number, float, nullable — The VAT that applies to purchases used for both taxable and non-taxable purposes.
    - `tax_non_credit_amount` number, float, nullable — The tax amount that cannot be claimed as a credit.
    - `vat_non_withheld` number, float, nullable — The VAT amount that was not withheld by the purchaser.
    - `tax_exempt_amount` number, float, nullable — The portion of the purchase that is exempt from VAT.
    - `credit_or_debit_note_on_purchase` boolean, nullable — Indicates whether the invoice is linked with a credit or debit note.
    - `tax_cigarettes_amount` number, float, nullable — The total tax amount applied on cigarettes.
    - `tax_cigar_amount` number, float, nullable — The total tax amount applied on cigars.
    - `tax_processed_tobacco_amount` number, float, nullable — The total tax amount applied on processed tobacco.
    - `additional_tax_amount` number, float, nullable — The total tax amount of the additional tax.
    - `additional_tax_rate` string, nullable — The tax rate of the additional tax.
    - `additional_tax_code` integer, nullable — The tax code for the additional tax.
  - `sales_invoice_details` object, nullable — Details regarding the sales invoice. If the invoice is a purchase invoice (`type` = `INFLOW`), this field will return `null`.
    - `construction_sector_tax_credit` number, float, nullable — The amount of tax credit applicable for construction companies.
    - `tax_free_trade_zone_amount` number, float, nullable — Tax applicable for transactions in free trade zones.
    - `container_deposit_guarantee` number, float, nullable — Refers to deposits or guarantees on containers, if applicable.
    - `is_free_of_charge` boolean, nullable — Indicated whether or not this sale was made at no cost (for example, the invoice is for promotional material, periodic free-of-charge resupplies, and similar).
    - `periodic_billing_type` boolean, nullable — Marks if the invoice is for periodic services.
    - `non_billable_amount` number, float, nullable — The portion of the transaction that is not billable.
    - `total_amount_for_period` number, float, nullable — The total amount for a specific period, often used for periodic billing.
    - `domestic_transportation_amount` number, float, nullable — The total amount spent on domestic transportation.
    - `international_transportation_amount` number, float, nullable — The total amount spent on international transportation.
    - `branch_code` integer, nullable — The code of the fiscal branch where the sales invoice was issued.
    - `tax_exempt_amount` number, float, nullable — The portion of the sale that is exempt from VAT.
    - `credit_or_debit_note_on_purchase` boolean, nullable — Indicates whether the invoice is linked with a credit or debit note.
    - `additional_tax_code` integer, nullable — The tax code for the additional tax.
    - `additional_tax_rate` string, nullable — The tax rate of the additional tax.
    - `additional_tax_amount` number, float, nullable — The total tax amount of the additional tax.
    - `vat_total_withheld` number, float, nullable — The total VAT withheld.
    - `vat_partially_withheld` number, float, nullable — The amount of VAT partially withheld.
    - `vat_non_withheld` number, float, nullable — The amount of VAT that was not withheld.
    - `vat_sales` number, float, nullable — The VAT amount corresponding to the seller's own sales.
    - `vat_third_party` number, float, nullable — VAT amount related to third-party sales if acting as an intermediary.
    - `vat_past_due` number, float, nullable — VAT that is accounted for or paid after the due date.
    - `invoice_settlement_sender_id` string, nullable — The RUT of the entity that issued the settlement for the invoice.
    - `invoice_settlement_net_commission` number, float, nullable — The net amount of commission in the invoice settlement.
    - `invoice_settlement_exempt_commission` number, float, nullable — The portion of the commission in the invoice settlement that is exempt from tax.
    - `invoice_settlement_vat_commission` number, float, nullable — VAT charged on the commission amount in the invoice settlement.
    - `reference_document_type` string, nullable — Indicates the type of document that this invoice refers to or is linked with.
    - `reference_document_folio` string, nullable — The folio number of the document referred to.
    - `foreign_recipient_id` string, nullable — The identification number of a foreign individual.
    - `foreign_recipient_nationality` string, nullable — The nationality of the foreign individual.
  - `summary_invoice_details` object — Details regarding the summary of `BOLETA_ELECTRONICA` or `COMPROBANTE_PAGO` invoices.
    - `month` string — The year and month of the invoices, in `YYYY-MM` format.
    - `updated_at` string, date-time — The ISO-8601 timestamp of when the list of invoices was last updated.
    - `total_documents` integer — The total number of invoices in the summary.
    - `tax_exempt_amount` number, float — The total invoice value (from all invoices in the summary) that is exempt from VAT.

## Other responses

- `201` — Created (when `save_data=true`)
- `202` — Request Accepted (when `X-Belvo-Request-Mode` is `async`)
- `400` — Bad request error
- `401` — Unauthorized
- `403` — Access to Belvo API denied
- `404` — Not Found Error
- `408` — Request Timeout
- `500` — Unexpected Error

---

[API](https://skmtc.net/belvo/apis/belvo-api-docs.md) · [All operations](https://skmtc.net/belvo/apis/belvo-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/belvo/belvo-api-docs/revisions/e82dca4a4b97/schema)