# Get deposit (/en/docs/conta-digital/endpoints/deposits/get_deposit)

## GET /transactions/deposit/{depositId}

`GET https://api.hub.payzu.com.br/api/v1/transactions/deposit/{depositId}`

Scope: `DEPOSIT_READ`. Returns a deposit, which is a Pix received on an account key without a charge. Use the `depositId` from the `DEPOSIT_RECEIVED` webhook.

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `depositId` | string | yes | Deposit identifier. |

### Responses

**200** Deposit.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | yes | Deposit identifier. |
| `method` | string | yes | Always `PIX`. — `PIX` |
| `amount` | integer | yes | Amount the payer sent. In cents. |
| `serviceFee` | integer | yes | Receiving fee. In cents. |
| `netAmount` | integer | yes | `amount − serviceFee`: what was credited. In cents. |
| `e2e` | string | yes | End-to-end ID of the received Pix. |
| `receiverPixKey` | string | null | yes | Key of your account that received it. |
| `payer` | object | yes | Who paid, as reported by the bank. |
| `payer.name` | string | null | yes | Name of who paid. |
| `payer.document` | string | null | yes | Masked CPF or formatted CNPJ. |
| `payer.bankIspb` | string | null | yes | ISPB of the payer institution. |
| `payer.bankName` | string | null | yes | Payer institution. |
| `paidAt` | string | yes | When the Pix arrived. — format: date-time |
| `createdAt` | string | yes | Date and time in ISO 8601, UTC. — format: date-time |
| `refundedAmount` | integer | yes | How much has been returned, completed returns only. In cents. |
| `refundInProgressAmount` | integer | yes | Return still being processed. In cents. |
| `refundableAmount` | integer | yes | How much can still be returned. `0` while a return is still being processed or a dispute is open. In cents. |
| `openInfractionProtocol` | string | null | yes | Protocol of the open MED dispute on the deposit. `null` when there is none. |
| `refunds` | object[] | yes | Returns of the deposit, newest first. |
| `refunds.id` | string | yes | Refund identifier. It is the `refundId` in the `REFUND_COMPLETED` and `REFUND_FAILED` webhooks. |
| `refunds.status` | string | yes | `RESERVED`: the amount left the available balance. `SENT`: sent to the bank. `SETTLED`: returned to the payer. `RELEASED`: refused, with the amount back in the balance. — `RESERVED`, `SENT`, `SETTLED`, `RELEASED` |
| `refunds.amount` | integer | yes | Amount returned to the payer. In cents. |
| `refunds.serviceFee` | integer | yes | Refund fee. In cents. |
| `refunds.totalDebited` | integer | yes | `amount + serviceFee`: what leaves the account. In cents. |
| `refunds.endToEndId` | string | null | yes | End-to-end ID of the return Pix. `null` until it completes. |
| `refunds.rejectedReason` | string | null | yes | Message ready to display, set when the bank refused the refund. |
| `refunds.requestedAt` | string | yes | When the refund was requested. ISO 8601, UTC. — format: date-time |
| `refunds.settledAt` | string | null | yes | When the refund completed. `null` until it completes. — format: date-time |
| `refunds.releasedAt` | string | null | yes | When the amount returned to the balance after a refusal. `null` if there was no refusal. — format: date-time |

**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. |

**404** Not found, or from another account.

| 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. |