---
title: "List"
method: GET
path: "/bills"
tags: ["Bill"]
---

# List

`GET /bills`

Recovers all credit card bills collected for the account provided

## Query parameters

- `accountId` string, uuid, required

## Response `200`

Retrieve a list of all credit card bills

- object
  - `page` number, double
  - `total` number, double
  - `totalPages` number, double
  - `results` Bill[] — List of credit card bills
    - `id` string, required — Primary identifier
    - `dueDate` string, date-time, required — Due date of the bill, displayed for payment by the customer
    - `billClosingDate` string, date-time, nullable — Date when the bill was closed
    - `totalAmount` number, required — Total bill amount
    - `totalAmountCurrencyCode` string, required — Code referencing the currency of the bill
    - `minimumPaymentAmount` number — Minimum payment amount of the bill
    - `allowsInstallments` boolean — Indicates whether the bill allows installment payments (true) or not (false)
    - `financeCharges` BillFinanceCharge[], required — List of charges associated to the bill
      - `id` string, required — Primary identifier
      - `type` 'LATE_PAYMENT_REMUNERATIVE_INTEREST' | 'LATE_PAYMENT_FEE' | 'LATE_PAYMENT_INTEREST' | 'IOF' | 'OTHER', required — Denomination of the charges that apply to the postpaid payment account bill
      - `amount` number, required — Amount charged for the charge/fee
      - `currencyCode` string, required — Code referencing the currency of the charge
      - `additionalInfo` string — Free field, mandatory to fill if 'OTHER' type of charge is selected
    - `payments` BillPayment[], required — List of payments associated to the bill
      - `id` string, required — Primary identifier
      - `valueType` 'INSTALLMENT_PAYMENT' | 'FULL_PAYMENT' | 'OTHER_PAYMENT', required — Classifies the payment value type
      - `paymentDate` string, date-time, required — Date when the payment was made
      - `paymentMode` 'DEBIT_ACCOUNT' | 'BANK_SLIP' | 'PAYROLL_DEDUCTION' | 'PIX', nullable — Payment mode used
      - `amount` number, required — Payment amount
      - `currencyCode` string, required — Code referencing the currency of the payment

---

[API](https://skmtc.dev/pluggy/apis/pluggy-api.md) · [All operations](https://skmtc.dev/pluggy/apis/pluggy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pluggy/pluggy-api/revisions/75e87ec7f9cd/schema)