---
title: "Get Refund"
method: GET
path: "/v1/refunds/{id}"
tags: ["PIX Refunds"]
---

# Get Refund

`GET /v1/refunds/{id}`

Retrieves a single PIX refund by its ID for the authenticated account.

## Path parameters

- `id` integer, required

## Response `200`

Refund retrieved successfully

- RefundItemResponse
  - `beneficiary` union
    - object
      - `pix_key` string, required
      - `resolved_account_number` string, nullable
      - `resolved_account_type` 'checking_account' | 'savings_account' | 'payment_account' | 'other_account' — Account types allowed in the Public API. checking_account, savings_account, payment_account, and other_account are supported.
      - `resolved_branch` string, nullable
      - `resolved_ispb` string, nullable
      - `name` string, nullable
      - `tax_id` string, nullable
    - object
      - `account_number` string, required
      - `account_type` 'checking_account' | 'savings_account' | 'payment_account' | 'other_account' — Account types allowed in the Public API. checking_account, savings_account, payment_account, and other_account are supported.
      - `branch_code` string, required
      - `ispb` string, required
      - `resolved_account_number` string, nullable
      - `resolved_account_type` 'checking_account' | 'savings_account' | 'payment_account' | 'other_account' — Account types allowed in the Public API. checking_account, savings_account, payment_account, and other_account are supported.
      - `resolved_branch` string, nullable
      - `resolved_ispb` string, nullable
      - `name` string, nullable
      - `tax_id` string, nullable
  - `cancelled_at` string, date-time, nullable — Cancellation timestamp (UTC, RFC 3339), if cancelled.
  - `created_at` string, date-time, required — Refund creation timestamp (UTC, RFC 3339).
  - `details` RefundDetailsResponse, required
    - `amount_in_cents` integer, required — Refund amount in cents
    - `message_to_payer` string, nullable — Optional message to the payer
  - `external_reference_id` string, nullable — External reference identifier provided by the client
  - `failed_message` string, nullable — Error message if the refund failed
  - `id` integer, required — Refund identifier
  - `status` 'pending' | 'processing' | 'success' | 'cancelled' | 'failed', required
  - `transaction_id` integer, required — Original transaction identifier
  - `updated_at` string, date-time, required — Last update timestamp (UTC, RFC 3339).

## Other responses

- `401` — Authentication failed
- `403` — Access denied - requires ViewTransactions permission
- `404` — Refund not found. Error code: PAYMENT_NOT_FOUND
- `500` — Internal server error

---

[API](https://skmtc.net/kiwify/apis/conta-digital-api.md) · [All operations](https://skmtc.net/kiwify/apis/conta-digital-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kiwify/conta-digital-api/revisions/5e009b25c245/schema)