# 列出转账 (/zh/docs/conta-digital/endpoints/internal-transfers/get_internal_transfers)

## GET /transactions/internal-transfer

`GET https://api.hub.payzu.com.br/api/v1/transactions/internal-transfer`

Scope: `INTERNAL_TRANSFER_READ`. Returns the transfers the account sent and received, 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 | Transfer status. — `REQUESTED`, `CONFIRMED`, `FAILED` |
| `side` | string | no | Only one side: `SENT` or `RECEIVED`. Without it, both are returned. — `SENT`, `RECEIVED` |
| `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 transfers.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `data` | object[] | yes | Sent and received transfers, newest first. |
| `data.id` | string | yes | Transfer identifier. The lookup accepts this `id` and the webhook `transferId`. |
| `data.status` | string | yes | `REQUESTED`: no result yet, after a `502` where the bank did not respond or refused temporarily. `CONFIRMED`: the amount is in the other account. `FAILED`: it did not go out. — `REQUESTED`, `CONFIRMED`, `FAILED` |
| `data.side` | string | yes | Side your account is on: `SENT` or `RECEIVED`. — `SENT`, `RECEIVED` |
| `data.amount` | integer | yes | Amount that reached the destination. In cents. |
| `data.serviceFee` | integer | yes | Fee. `0` on the receiving side. In cents. |
| `data.totalDebited` | integer | yes | `amount + serviceFee`. `0` on the receiving side. In cents. |
| `data.counterparty` | object | yes | The other account. |
| `data.counterparty.name` | string | yes | Name of the other account. |
| `data.counterparty.document` | string | yes | Document of the other account: masked CPF or formatted CNPJ. Empty when unknown. |
| `data.counterparty.pixKey` | string | yes | Key of the other account. In full in the `POST` response; in lookups and lists, CPF, email and phone keys are masked. |
| `data.comment` | string | null | yes | Receipt text. |
| `data.providerRejectedReason` | string | null | yes | Message ready to display, set when `FAILED`. |
| `data.callbackUrl` | string | null | yes | The `callbackUrl` sent on creation. `null` when none was sent. `null` on the receiving side. |
| `data.createdAt` | string | yes | Date and time in ISO 8601, UTC. — format: date-time |
| `data.confirmedAt` | string | null | yes | When it completed. `null` until it completes. — format: date-time |
| `data.failedAt` | string | null | yes | When it failed. `null` if it did not fail. — 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. |