# 收款列表 (/zh/docs/cartao/endpoints/charges/get_charges)

## GET /charges

`GET https://api.payzu.io/v1/charges`

Returns a list of charges

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `startDate` | string | no | Start date to filter the results |
| `endDate` | string | no | End date to filter the results |
| `limit` | number | no | Maximum number of items to return in the query — default: 10 |
| `page` | number | no | Page number for result pagination — default: 1 |
| `recurrentPaymentId` | string | no | Filters the initial charge and the cycles generated by a recurrence |

### Responses

**200** Successful request

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `page` | integer | no | Current page |
| `total` | integer | no | Total charges found |
| `totalPages` | integer | no | Total pages |
| `charges` | object[] | no |  |
| `charges.id` | string | no | Charge identifier |
| `charges.externalId` | string | no | Unique identifier generated externally |
| `charges.postbackUrl` | string | no | Url for notifications about the charge status |
| `charges.amount` | number | no | Charge amount in cents |
| `charges.paymentType` | string | no | Charge payment type. See [Payment types](https://docs.payzu.com.br/docs/cartao/reference-codes) |
| `charges.createdAt` | string | no | Charge creation date |
| `charges.updatedAt` | string | no | Date the charge was last updated |
| `charges.customer` | object | no | Buyer data |
| `charges.customer.id` | number | no | Buyer identifier. |
| `charges.customer.name` | string | no | Buyer's full name |
| `charges.customer.identity` | string | no | Buyer's identification document number |
| `charges.customer.identityType` | string | no | Buyer's identification document type |
| `charges.customer.email` | string | no | Buyer's email |
| `charges.customer.birthdate` | string | no | Buyer's birthdate |
| `charges.customer.phone` | string | no | Buyer's phone number |
| `charges.customer.address` | object | no | Billing address |
| `charges.cart` | object[] | no | Buyer's cart |
| `charges.cart.name` | string | yes | Product name |
| `charges.cart.quantity` | number | yes | Product quantity |
| `charges.cart.sku` | string | yes | Product SKU (Stock Keeping Unit) |
| `charges.cart.unitPrice` | number | yes | Product unit price in cents |
| `charges.creditCardPayment` | object | no | Credit card payment details |
| `charges.creditCardPayment.installments` | number | no | Number of installments |
| `charges.creditCardPayment.authenticate` | boolean | no | Indicates whether the buyer was redirected to the issuer for 3DS authentication |
| `charges.creditCardPayment.currency` | string | no | Charge currency. See [Currencies](https://docs.payzu.com.br/docs/cartao/reference-codes) |
| `charges.creditCardPayment.acquirerTransactionId` | string | no | Transaction identifier at the acquirer |
| `charges.creditCardPayment.authorizationCode` | string | no | Authorization code returned by the acquirer |
| `charges.creditCardPayment.reasonCode` | number | no | Reason code of the result. See [ReasonCode/ReasonMessage list](https://docs.payzu.com.br/docs/cartao/reason-codes) |
| `charges.creditCardPayment.reasonMessage` | string | no | Reason message of the result. See [ReasonCode/ReasonMessage list](https://docs.payzu.com.br/docs/cartao/reason-codes) |
| `charges.creditCardPayment.status` | integer | no | Transaction status. See [Transaction status list](https://docs.payzu.com.br/docs/cartao/transaction-status) |
| `charges.creditCardPayment.returnCode` | string | no | Return code from the acquirer. See [Error Codes](https://docs.payzu.com.br/docs/cartao/error-codes) and [ABECS return codes](https://docs.payzu.com.br/docs/cartao/abecs-codes) |
| `charges.creditCardPayment.returnMessage` | string | no | Return message from the acquirer |
| `charges.creditCardPayment.externalAuthentication` | object | no | External 3DS authentication data, when sent at creation |
| `charges.creditCardPayment.reversedAmount` | number | no | Reversed amount in cents, when a reversal exists |
| `charges.creditCardPayment.reversedDate` | string | no | Reversal date, when present |
| `charges.creditCardPayment.chargeId` | string | no | Charge identifier |
| `charges.creditCardPayment.card` | object | no | Details of the card used in the charge |
| `charges.creditCardPayment.chargebacks` | object[] | no | Chargebacks linked to the charge |
| `charges.recurrence` | object | no | State of a recurrence |
| `charges.recurrence.recurrentPaymentId` | string | no | Recurrence identifier. Use it on the recurrence query and management endpoints |
| `charges.recurrence.interval` | string | no | Configured interval — `MONTHLY`, `ANNUAL` |
| `charges.recurrence.status` | string | no | Recurrence status. See [Recurring Payments](https://docs.payzu.com.br/docs/cartao/recurrence) — `ACTIVE`, `INACTIVE`, `ENDED` |
| `charges.recurrence.amount` | number | no | Amount of each cycle, in cents |
| `charges.recurrence.nextRecurrency` | string | no | Date of the next automatic charge |
| `charges.recurrence.endDate` | string | no | End date, if provided at creation |
| `charges.recurrenceCycle` | integer | no | Cycle number of the recurrence this charge belongs to: 0 is the initial charge, 1..n are the automatically generated cycles. Present only on recurrence charges |