---
title: "Retrieve Refund Status"
method: GET
path: "/refunds/{refund_id}"
tags: ["Refunds"]
---

# Retrieve Refund Status

`GET /refunds/{refund_id}`

Retrieve the status of a previously created refund.
You can trigger the check of the status of a refund at any moment you consider pertinent. 
However, every time a refund changes its status, we will send you a notification containing 
the ID of the refund so that you can check its status back to retrieve the new refund's status.

Regarding the Authorization value, since the body of the requests will be empty, you should use 
an empty ("") string or nothing as the jsonPayload field for generating the signature.

## Path parameters

- `refund_id` integer, required

## Query parameters

- `voucher` boolean

## Headers

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

## Response `200`

Refund status successfully retrieved.

- RefundStatusSuccess — Details of the refund status. The API may add more fields to this response object in the future; integrations should be tolerant of new fields.
  - `deposit_id` integer — ID of the deposit refunded.
  - `merchant_invoice_id` string — Merchant invoice id of the deposit refunded.
  - `status` 'PENDING' | 'DELIVERED' | 'COMPLETED' | 'INCORRECT_DETAILS' | 'REJECTED' | 'CANCELLED' — Status of the refund. Possible values: - `PENDING`: The refund request has been created and is awaiting processing. - `DELIVERED`: The refund has been sent for processing. - `COMPLETED`: The refund has been successfully processed. - `INCORRECT_DETAILS`: More information is needed, or details were incorrect. - `REJECTED`: The refund was rejected (e.g., by the bank). - `CANCELLED`: The refund was manually cancelled (only possible in PENDING or INCORRECT_DETAILS).
  - `amount` number, float — Amount of the refund. This field is typically present when the status is `COMPLETED`.
  - `voucher` string, byte — Proof of refund in base64 coding for generation of a .pdf file. Included in the response only if `voucher` is sent as `true` in the query parameters.

## Other responses

- `401` — Unauthorized access. This could be due to an invalid X-Login, X-Date, or Authorization signature.
- `404` — The refund with the specified `refund_id` 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)