---
title: "List funds recovery refund requests [beta]"
method: GET
path: "/v1/pix/funds-recoveries/{funds_recovery_id}/refunds"
tags: ["Funds recovery"]
---

# List funds recovery refund requests \[beta\]

`GET /v1/pix/funds-recoveries/{funds_recovery_id}/refunds`

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/v1/pix/funds-recoveries/{funds_recovery_id}/refunds`
- Auth: none declared. Required headers: `Authorization`

Get a list of refund requests for a funds recovery

## Path parameters

- `funds_recovery_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

List funds recovery refunds response

- ListFundsRecoveryRefundsResponse
  - `response_date_time` string, date-time: Response date time. RFC 3339 date-time value.
  - `infractions` 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`: Invalid funds recovery ID
- `403`: No permission
- `404`: Not found
- `504`: Timeout

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)