# List withdrawals (/en/docs/conta-digital/endpoints/withdrawals/get_withdraws)

## GET /transactions/withdraw

`GET https://api.hub.payzu.com.br/api/v1/transactions/withdraw`

Scope: `WITHDRAW_READ`. Returns the account withdrawals, including Pix copy-and-paste payments, newest first, cursor paginated.

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `limit` | integer | no | Items per page, 1 to 100. — minimum: 1; maximum: 100; default: 20 |
| `cursor` | string | no | `nextCursor` from the previous page. |
| `status` | string | no | Withdrawal status. — `REQUESTED`, `CREATED`, `APPROVED`, `CONFIRMED`, `FAILED` |
| `dateFrom` | string | no | Start of the period, by creation date. ISO 8601 or `YYYY-MM-DD`; a date without a time covers the whole day in Brasília time. |
| `dateTo` | string | no | End of the period, by creation date. ISO 8601 or `YYYY-MM-DD`; a date without a time covers the whole day in Brasília time. |

### Responses

**200** Page of withdrawals.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `data` | object[] | yes | Withdrawals and Pix copy-and-paste payments of the account, newest first. |
| `data.id` | string | yes | Withdrawal identifier. The lookup accepts this `id` and the webhook `withdrawId`. |
| `data.status` | string | yes | `REQUESTED`: requested; the amount has already left the available balance. `CREATED`: registered at the bank. `APPROVED`: approved, on its way. `CONFIRMED`: the money arrived. `FAILED`: it did not go out, and the amount returned to the balance; it can come from `REQUESTED`, `CREATED` or `APPROVED`. — `REQUESTED`, `CREATED`, `APPROVED`, `CONFIRMED`, `FAILED` |
| `data.operation` | string | yes | `WITHDRAW`: withdrawal to a key. `EXTERNAL_PAYMENT`: Pix copy-and-paste payment. — `WITHDRAW`, `EXTERNAL_PAYMENT` |
| `data.amount` | integer | yes | Amount that reaches the destination. In cents. |
| `data.serviceFee` | integer | yes | Fee, added on top. In cents. |
| `data.totalDebited` | integer | yes | `amount + serviceFee`: what leaves the account. In cents. |
| `data.destination` | object | yes | Withdrawal destination. |
| `data.destination.pixKey` | string | yes | Destination key, masked: CPF, email and phone keys are masked; CNPJ and random keys are shown in full. |
| `data.destination.pixKeyType` | string | null | yes | Key type, inferred from the format. — `EVP`, `CNPJ`, `CPF`, `EMAIL`, `PHONE` |
| `data.comment` | string | null | yes | Text sent to the recipient. |
| `data.e2e` | string | null | yes | End-to-end ID of the Pix. `null` until the bank registers it. |
| `data.createdAt` | string | yes | Date and time in ISO 8601, UTC. — format: date-time |
| `data.confirmedAt` | string | null | yes | When the money reached the destination. — format: date-time |
| `nextCursor` | string | no | Cursor for the next page. Absent on the last page. |

**400** Invalid request.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Description in Portuguese, ready to display. It may change at any time. |
| `code` | string | yes | Stable error code. Your system decides what to do based on it. |
| `details` | object | no | Structured error context, when available. |

**401** Missing, invalid or expired credential.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Description in Portuguese, ready to display. It may change at any time. |
| `code` | string | yes | Stable error code. Your system decides what to do based on it. |
| `details` | object | no | Structured error context, when available. |

**403** Not allowed: scope, IP or disabled operation.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Description in Portuguese, ready to display. It may change at any time. |
| `code` | string | yes | Stable error code. Your system decides what to do based on it. |
| `details` | object | no | Structured error context, when available. |