---
title: "Retrieve Cashout Status"
method: POST
path: "/v3/cashout/status"
tags: ["Cashout"]
---

# Retrieve Cashout Status

`POST /v3/cashout/status`

This API allows you to retrieve the status of a cashout.

## Headers

- `Content-Type` string, required
- `Payload-Signature` string, required

## Request body

- object
  - `login` string, required — Your D24 CASHOUTS API login key. Length 32 max.
  - `pass` string, required — Your D24 CASHOUTS API pass key. Length 32 max.
  - `cashout_id` number — The ID of the cashout to check status of. It is the one generated by D24 when the cashout was created. (Required if external_id is not provided)
  - `external_id` string — The ID of the cashout to check status of. It is the one you sent when the cashout was created. (Required if cashout_id is not provided)

## Response `200`

The status of the cashout was successfully retrieved.

- object
  - `cashout_status` 0 | 1 | 2 | 3 | 4 | 5 — Status code of the cashout. - 0: PENDING - The cashout was accepted by D24 but it wasn't sent to the bank yet. It can still be Canceled. - 1: COMPLETED - The money reached the customer's account. - 2: CANCELLED - The cashout was cancelled by you. - 3: REJECTED - The cashout was rejected by the bank due to invalid bank account, account closed, etc. - 4: DELIVERED - The cashout was sent to the bank for processing. At this point it can't be cancelled anymore. - 5: ON HOLD - Cashout set to on hold by you. It won't be processed until manually changed again to Pending status.
  - `cashout_status_description` string — Description of the status. (e.g., "Completed", "Pending", etc.)
  - `rejection_code` 800 | 801 | 802 | 803 | 804 | 805 | 806 | 807 | 808 | 809 | 810 | 811 | 812 | 813 | 814 | 815 | 816 | 817 | 818 | 819 | 820 | 821 | 822 | 824 — Rejection code if the cashout status is REJECTED. See `enum` for possible bank rejection codes.
  - `rejection_reason` string — Textual reason for rejection, corresponding to the rejection_code. (e.g., "ERROR_ACCOUNT_INCORRECT")
  - `provider_external_reference` string — ID of the transaction on the bank side. For Pix, it's the E2E ID (End-to-end).
  - `bank` object — Object containing information about the bank of the beneficiary.
    - `code` string — Code of the bank of the beneficiary.
    - `name` string — Name of the bank of the beneficiary.
    - `branch` string — Branch of the beneficiary's bank account.
    - `account` string — Account number of the beneficiary's bank account.
    - `beneficiary_name` string — Name of the owner of the account.

## Other responses

- `400` — Bad Request. This can be due to various reasons including invalid parameters, malformed JSON, KYC errors, or other client-side errors. Specific error codes and messages will be provided in the response body.
- `401` — Unauthorized access. This can be due to invalid credentials or an unregistered IP address.
- `412` — Precondition Failed. Typically indicates the cashout ID was not found.
- `500` — Internal Server Error. This can be due to various server-side issues. Specific error codes and messages may be provided in the response body.

---

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