---
title: "Retrieve Deposit Status"
method: GET
path: "/deposits/{deposit_id}"
tags: ["Deposits"]
---

# Retrieve Deposit Status

`GET /deposits/{deposit_id}`

Retrieve the status of a previously created deposit. This endpoint allows you to retrieve the status of a deposit request.

## Path parameters

- `deposit_id` integer, required

## Headers

- `Content-Type` string, required
- `X-Date` string, date-time, required
- `X-Login` string, required
- `Authorization` string, required
- `X-Idempotency-Key` string

## Response `200`

Deposit status successfully retrieved

- DepositStatusResponse
  - `user_id` string — ID generated for the user on D24 end
  - `deposit_id` integer — ID of the deposit on D24 end
  - `subscription_id` integer, nullable — ID of the Subscription that triggered the deposit
  - `invoice_id` string — ID of the deposit on the merchant end
  - `country` string, nullable — Country ISO code
  - `currency` string — Local currency code
  - `local_amount` number, float, nullable — Amount in local currency
  - `usd_amount` number, float, nullable — Amount in USD
  - `amount` number, float, nullable — Amount in local currency (may appear in PENDING/CREATED status responses; prefer 'local_amount' or 'usd_amount' where available)
  - `bonus_amount` number, float, nullable — The amount specified as bonus in the request
  - `bonus_relative` boolean, nullable — Specifies if the bonus_amount is absolute or relative. Only shown if bonus_amount is not null.
  - `payment_method` string, nullable — Payment method code specified on the deposit request or selected by the user. Only shown if payment method is selected.
  - `payment_type` string, nullable — Type of the payment method. Only shown if payment method is selected.
  - `status` 'COMPLETED' | 'PENDING' | 'CREATED' | 'DECLINED' | 'CANCELLED' | 'EXPIRED' | 'EARLY_RELEASED' | 'FOR_REVIEW' — Status of the deposit
  - `payer` Payer
    - `id` string, required — Unique identifier for the payer
    - `document` string, required — Payer's identification document number
    - `document_type` string, required — Type of identification document
    - `email` string, email, required — Payer's email address
    - `first_name` string, required — Payer's first name
    - `last_name` string, required — Payer's last name
  - `fee_amount` number, float, nullable — Fee of the deposit in the currency of your balance. Only shown if payment_method was sent or selected.
  - `fee_currency` string, nullable — Currency of your balance. Only shown if payment_method was sent or selected.
  - `refunded` boolean, nullable — Shows if the deposit was refunded or not
  - `current_payer_verification` 'MATCH' | 'UNMATCH' | 'NO_CLIENT_DOCUMENT' | 'NO_CURRENT_PAYER_DATA', nullable — Shows if the current payer is the same person who creates the deposit. Only shown if not null.
  - `card_detail` CardDetail — Details about the credit card of the payer. Only shown for credit card deposits when information is available.
    - `card_holder` string — Name of the card holder used to pay
    - `brand` string — Brand of the card used to pay
    - `masked_card` string — Masked card number used to pay
    - `expiration` string — Expiration of the card used to pay in format<y_bin_46>-MM. Example: 2023-12
    - `card_type` 'CREDIT' | 'DEBIT' — Type of card used CREDIT/DEBIT
    - `transaction_result` string — The result message of the credit card transaction
  - `financial_institution` FinancialInstitution — (Only for Pix deposits) Object containing additional information about the financial institution.
    - `name` string — Name of the bank from which the deposit was completed
    - `bank_code` string — The Cashout Bank Code of the bank
    - `tax_identifier` string — The Tax ID of the bank (e.g., in Brazil is the bank's CNPJ)
  - `bank_account` BankAccount
    - `bank_code` string — The code of the bank.
    - `account` string — The user's bank account number.
    - `branch` string — The bank branch number.
    - `account_type` string — The type of bank account.
  - `completed_payment_method_code` string, nullable — Payment method used by the client to complete the transaction

## Other responses

- `400` — The deposit_id specified is not valid
- `401` — Unauthorized access
- `404` — The deposit_id specified could not be found

---

[API](https://skmtc.dev/d24/apis/docs-d24-com.md) · [All operations](https://skmtc.dev/d24/apis/docs-d24-com/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/d24/docs-d24-com/revisions/fb0e2ddec198/schema)