---
title: "List refunds"
method: GET
path: "/v2/pix/refunds"
tags: ["Refunds"]
---

# List refunds

`GET /v2/pix/refunds`

List DICT refunds for an organization.

## Query parameters

- `participant_role` 'CONTESTED' | 'REQUESTED', required
- `funds_recovery_id` string
- `include_details` boolean
- `limit` integer
- `modified_after` string, date-time
- `modified_before` string
- `status` 'OPEN' | 'CLOSED' | 'CANCELLED'

## Headers

- `x-tenant` string, required
- `x-cid` string

## Response `200`

List refunds

- RefundListResponse
  - `has_more_elements` boolean, required — Are there more items?
  - `items` Refund[]
    - `contested_participant` string, required — Challenged participant's ISPB (Identifcador do Sistema de Pagamento Brazil) number - the Brazilian Payment System identifier, an 8-digit value.
    - `creation_date_time` string, date-time, required — Creation date time. RFC 3339 date-time value.
    - `last_modified` string, date-time, required — Last modified date time. RFC 3339 date-time value.
    - `refund_amount` string, required — Refund amount
    - `refund_id` string, required — Refund ID
    - `refund_reason` 'FRAUD' | 'OPERATIONAL_FLAW' | 'PIX_AUTOMATICO' | 'REFUND_CANCELLED', required — Refund reason. `PIX_AUTOMATICO` means a refund was requested due to failed Automatic Pix operation.
    - `requesting_participant` string, required — Requesting participant's ISPB (Identifcador do Sistema de Pagamento Brazil) number - the Brazilian Payment System identifier, an 8-digit value.
    - `status` 'OPEN' | 'CLOSED' | 'CANCELLED', required — Refund status
    - `transaction_id` string, required — Refund transaction ID
    - `correlation_id` string — The Correlation identifier field is used to link related API requests and events. The CID can help the Pismo engineering team track everything related to a call. If not passed, a random one is generated. You can find the CID in the response header.
    - `infraction_report_id` string, uuid — Infraction report ID (UUID)
    - `refund_analysis_details` string — Refund analysis details
    - `refund_analysis_result` 'TOTALLY_ACCEPTED' | 'PARTIALLY_ACCEPTED' | 'REJECTED' — Respondent's refund request analysis result.
    - `refund_details` string — Details about refund
    - `refund_rejection_reason` 'NO_BALANCE' | 'ACCOUNT_CLOSURE' | 'INVALID_REQUEST' | 'OTHER' — Refund rejecton reason. **REQUIRED** when `refund_analysis_result` is `REJECTED`.
    - `refund_account` RefundAccount
      - `tax_id_number` string — A government document number, such as a Social Security number (US) or Cadastro de Pessoas Físicas number (Brazil). Must be numeric with 11-14 digits.
      - `participant` string — Participant's ISPB (Identifcador do Sistema de Pagamento Brazil) number - the Brazilian Payment System identifier, an 8-digit value.
      - `branch` string — This could be a bank-assigned branch ID or the branch's ISPB number.
      - `account_number` string — Account number.
      - `account_type` 'CACC' | 'SLRY' | 'SVGS' | 'TRAN' — Account type: <br /> `CACC` - Checking/current account. Known as "conta corrente" in Portuguese, this is a bank account type designed for everyday financial transactions and is the most common type individuals and businesses use for day-to-day banking.<br /> `SVGS` - Savings account<br /> `TRAN` - Payment account. Payment institutions offer payment accounts to move funds and make payments, while banks offer checking accounts that include full financial services such as credit and investments.<br /> `SLRY` - Salary account. Employer deposits a fixed amount every month.<br />
    - `refund_transaction_id` string — Refund transaction ID
    - `funds_recovery_id` string — Funds recovery identifier. Returned from the [Create funds recovery](https://developers.pismo.io/pismo-docs/reference/post-create-funds-recovery) endpoint.
    - `monitor_account` boolean — Should the account be monitored for suspicious activity?
    - `effective_refunded_amount` number — Actual amount refunded to the user.

## Other responses

- `400` — Bad request
- `403` — The request has been lost
- `404` — Not Found
- `500` — Internal server error
- `502` — Bad Gateway
- `504` — Gateway timeout

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)