---
title: "Listar/Buscar Faturas"
method: GET
path: "/invoices"
---

# Listar/Buscar Faturas

`GET /invoices`

Retorna uma lista das faturas em sua conta ordenadas pela data de criação, da mais à menos recente. Por padrão, este endpoint retorna no máximo 100 registros. O campo "totalItems" contém sempre a quantidade total de faturas cadastradas, independentemente dos parâmetros de pesquisa utilizados, e o resultado da pesquisa fica sempre dentro de "items".

## Query parameters

- `limit` integer
- `start` integer
- `created_at_from` string, date-time
- `created_at_to` string, date-time
- `paid_at_from` string, date-time
- `paid_at_to` string, date
- `due_date` string, date
- `query` string
- `updated_since` string, date-time
- `customer_id` string
- `status_filter` string

## Response `200`

200

- object
  - `items` object[]
    - `id` string
    - `due_date` string
    - `currency` string
    - `discount_cents` unknown
    - `email` string
    - `notification_url` unknown
    - `return_url` unknown
    - `status` string
    - `tax_cents` unknown
    - `total_cents` integer
    - `total_paid_cents` integer
    - `taxes_paid_cents` unknown
    - `paid_at` unknown
    - `paid_cents` unknown
    - `cc_emails` unknown
    - `payable_with` string
    - `overpaid_cents` unknown
    - `ignore_due_email` unknown
    - `ignore_canceled_email` unknown
    - `advance_fee_cents` unknown
    - `commission_cents` unknown
    - `early_payment_discount` boolean
    - `order_id` unknown
    - `updated_at` string
    - `credit_card_brand` unknown
    - `credit_card_bin` unknown
    - `credit_card_last_4` unknown
    - `credit_card_captured_at` unknown
    - `credit_card_tid` unknown
    - `external_reference` unknown
    - `max_installments_value` unknown
    - `payer_name` unknown
    - `payer_email` unknown
    - `payer_cpf_cnpj` unknown
    - `payer_phone` unknown
    - `payer_phone_prefix` unknown
    - `payer_address_zip_code` unknown
    - `payer_address_street` unknown
    - `payer_address_district` unknown
    - `payer_address_city` unknown
    - `payer_address_state` unknown
    - `payer_address_number` unknown
    - `payer_address_complement` unknown
    - `payer_address_country` unknown
    - `late_payment_fine` integer
    - `late_payment_fine_cents` unknown
    - `split_id` unknown
    - `external_payment_id` unknown
    - `external_payment_description` unknown
    - `payment_booklet_id` unknown
    - `subscription_id` unknown
    - `variables` object[]
    - `custom_variables` object[]
    - `logs` object[]
    - `credit_card_transaction` unknown
    - `account_id` string
    - `bank_account_branch` unknown
    - `bank_account_number` unknown
    - `account_name` string
    - `secure_id` string
    - `secure_url` string
    - `customer_id` unknown
    - `customer_ref` unknown
    - `customer_name` unknown
    - `user_id` unknown
    - `total` string
    - `taxes_paid` string
    - `total_paid` string
    - `total_overpaid` string
    - `total_refunded` string
    - `fine_cents` integer
    - `commission` string
    - `fines_on_occurrence_day` string
    - `total_on_occurrence_day` string
    - `fines_on_occurrence_day_cents` integer
    - `total_on_occurrence_day_cents` integer
    - `refunded_cents` integer
    - `remaining_captured_cents` integer
    - `financial_return_date` unknown
    - `advance_fee` unknown
    - `estimated_advance_fee` unknown
    - `paid` string
    - `original_payment_id` unknown
    - `double_payment_id` unknown
    - `per_day_interest` boolean
    - `per_day_interest_value` unknown
    - `per_day_interest_cents` integer
    - `interest` unknown
    - `discount` unknown
    - `duplicated_invoice_id` unknown
    - `bank_slip_extra_due` integer
    - `created_at` string
    - `created_at_iso` string
    - `authorized_at` unknown
    - `authorized_at_iso` unknown
    - `expired_at` unknown
    - `expired_at_iso` unknown
    - `refunded_at` unknown
    - `refunded_at_iso` unknown
    - `canceled_at` unknown
    - `canceled_at_iso` unknown
    - `protested_at` unknown
    - `protested_at_iso` unknown
    - `chargeback_at` unknown
    - `chargeback_at_iso` unknown
    - `occurrence_date` unknown
    - `refundable` unknown
    - `installments` unknown
    - `transaction_number` unknown
    - `payment_method` unknown
    - `financial_return_dates` unknown
    - `bank_slip` unknown
    - `pix` object
      - `qrcode` unknown
      - `qrcode_text` unknown
      - `status` unknown
      - `payer_cpf_cnpj` unknown
      - `payer_name` unknown
      - `end_to_end_id` unknown
      - `end_to_end_refund_id` unknown
      - `account_number_last_digits` unknown
    - `items` object[]
      - `id` string
      - `description` string
      - `price_cents` integer
      - `quantity` integer
      - `created_at` string
      - `updated_at` string
      - `price` string
    - `early_payment_discounts` object[]
    - `split_rules` unknown
  - `facets` object
    - `late` object
      - `_type` string
      - `count` integer
    - `status` object
      - `_type` string
      - `missing` integer
      - `other` integer
      - `terms` object[]
        - `term` string
        - `count` integer
      - `total` integer
  - `totalItems` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/revisions/4590fc729d1e/schema)