---
title: "Get a refund"
method: GET
path: "/refunds/{id}"
tags: ["Refunds"]
---

# Get a refund

`GET /refunds/{id}`

Retrieves a refund by its `id`. Only refunds matching the `live` or `test` mode of the API key are visible.

## Path parameters

- `id` string, required

## Response `200`

The refund with the given `id`.

- RefundsRefund — A refund returns funds from a succeeded payment to the payer. Fintoc disburses refunds asynchronously, so a refund moves through `pending`, `in_progress`, and `succeeded`, or ends in `failed` or `canceled`. The `amount` and `currency` are denominated in the smallest unit of the refunded resource's currency.
  - `id` string, required — Unique identifier of the refund.
  - `object` 'refund', required — Type of the object. Always `refund`.
  - `amount` integer, required — Amount refunded, as an integer in the smallest unit of `currency` (for example, `5000` for $5000 CLP, since CLP has no minor unit).
  - `created_at` string, date-time, required — ISO 8601 timestamp of when the refund was created.
  - `currency` 'CLP' | 'MXN', required — Three-letter ISO 4217 currency code. Always matches the currency of the refunded resource.
  - `failure_code` string, nullable, required — Reason why the refund failed. One of `fraud_risk` (the disbursement was blocked by Fintoc's fraud checks) or `insufficient_funds` (your organization did not have enough funds to cover the refund). `null` unless the refund failed.
  - `metadata` object, required — Set of key-value pairs attached to the refund when it was created.
  - `mode` 'test' | 'live', required — Mode of the object. `live` objects use real institution data, `test` objects use fake data for integration testing.
  - `recipient_account` object, nullable, required — Bank account that receives the refunded funds. `null` for refunds that are not disbursed by bank transfer (for example, card refunds).
    - `holder_id` string, required — Tax ID of the account holder, without dots or hyphen.
    - `holder_name` string, required — Name of the account holder.
    - `institution_id` string, required — Identifier of the institution where the account lives.
    - `number` string, required — Number of the account that receives the funds.
    - `type` 'checking_account' | 'sight_account', required — Type of the bank account. One of `checking_account` or `sight_account`.
  - `resource_id` string, required — ID of the refunded resource.
  - `resource_type` 'payment_intent', required — Type of the refunded resource. Always `payment_intent`.
  - `status` 'pending' | 'in_progress' | 'succeeded' | 'failed' | 'canceled', required — Current status of the refund. One of `pending` (the disbursement has not started), `in_progress` (Fintoc is disbursing the funds), `succeeded` (the funds reached the recipient account), `failed` (the disbursement failed; see `failure_code`), or `canceled` (the refund was canceled before disbursing).
  - `updated_at` string, date-time, required — ISO 8601 timestamp of when the refund was last updated.

## Other responses

- `401` — Invalid or missing API key.
- `404` — The refund does not exist, belongs to another organization, or belongs to a different mode than the API key.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/revisions/9dafa63688a3/schema)