---
title: "List all invoices"
method: GET
path: "/sellers/{seller_id}/invoices"
tags: ["Invoices"]
---

# List all invoices

`GET /sellers/{seller_id}/invoices`

## Path parameters

- `seller_id` string, required — An object id with prefix

## Query parameters

- `skip` integer — For pagination, skip a number of results
- `take` integer — Only take up to a number of results.
- `id` string — A cursor (bookmark) used to only return results equal or lower than the given id. More efficient than skip for large result sets.
- `metadata` object — Metadata filters, use the following format to construct a clause for a metadata search: metadata["<field>"]:<value>

## Response `200`

Successful operation

- object — List of items
  - `data` object[], required
    - `buyer_id` string, required — Identifier for the buyer
    - `currency` string, required — ISO 4217 currency code for all monetary amounts on this invoice
    - `country` string, required — ISO 3166-1 alpha-2 country code where the invoice is issued
    - `amount_due` integer, required — Total amount due on the invoice
    - `amount_paid` integer, required — Amount already paid on this invoice
    - `amount_remaining` integer, required — Amount still remaining to be paid
    - `invoice_date` string, date, required — Date when the invoice was issued
    - `due_date` string, date, required — Date when the payment is due
    - `total` integer, required — Total amount of the invoice including all charges, shipping, tax, etc.
    - `supplier_id` string — Identifier for the supplier, if different from seller
    - `invoice_pdf` string, uri — URL to the PDF version of the invoice
    - `billing_reason` string — Reason for billing the buyer
    - `payment_method` string — Payment method used or to be used for this invoice
    - `charges` integer — Amount of charges applied to this invoice
    - `discount` integer — Amount of discount applied to this invoice
    - `shipping` integer — Shipping costs included in this invoice
    - `tax` integer — Tax amount applied to this invoice
    - `fiscal_invoice_id` union — Fiscal invoice identifier
      - string — CFDI (Comprobante Fiscal Digital por Internet - Mexico) - A UUID identifier for Mexican digital fiscal invoices with cfdi: prefix
      - string — NFe (Nota Fiscal Eletrônica - Brazil) - A 44-digit access key (Chave de Acesso) for Brazilian electronic invoices with nfe: prefix
      - string — PEPPOL (Pan-European Public Procurement OnLine) - A PEPPOL participant identifier with scheme ID and value, with peppol: prefix
    - `metadata` object — Additional custom data associated with this invoice
    - `id` string, required — An object id with prefix
    - `created_at` string, date-time, required — Creation date and time
    - `created_by` string, required — ID of the user that created this object
    - `updated_at` string, date-time, required — Last update date and time
    - `updated_by` string, required — ID of the user that last updated this object

---

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