---
title: "List invoices"
method: GET
path: "/api/cl/invoices/"
tags: ["Invoices Chile"]
---

# List invoices

`GET /api/cl/invoices/`

## ▶️ Usage

With the List Invoices method, you can:

1. List invoices related to a specific `link.id` (using the `link` query parameter).
2. Get the details of a specific `invoice.id` (using the `id` query parameter).
3. **[Not Recommended]** List all invoices related to your Belvo account (without using any query parameters).

## 📖 Pagination

This method returns a paginated response (default: 100 items per page). You can use the `page_size` query parameter to increase the number of items returned to a maximum of 1000 items. You can use the `page` query parameter to navigate through the results. For more details on how to navigate Belvo's paginated responses, see our <a href="https://developers.belvo.com/docs/belvo-pagination-tips" target="_blank">Pagination Tips</a> article.

## 🔦 Filtering Responses

Please see the query list below for a list of fields that you can filter your responses by. For more information on how to use filters, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> article.

## Query parameters

- `link` string, uuid
- `page_size` integer
- `page` integer
- `omit` string
- `fields` string
- `link__in` string[]
- `id` string, uuid
- `id__in` string[]
- `created_at` string, date
- `created_at__gt` string, date
- `created_at__gte` string, date
- `created_at__lt` string, date
- `created_at__lte` string, date
- `created_at__range` string[]

## Response `200`

Ok

- object
  - `count` integer — The total number of results in your Belvo account.
  - `next` string, uri, nullable — The URL to next page of results. Each page consists of up to 100 items. If there are not enough results for an additional page, the value is `null`. In our documentation example, we use `{endpoint}` as a placeholder value. In production, this value will be replaced by the actual endpoint you are currently using (for example, `accounts` or `owners`).
  - `previous` string, uri, nullable — The URL to the previous page of results. If there is no previous page, the value is `null`.
  - `results` InvoiceChile[] — Array of invoice objects.
    - `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

- `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)