---
title: "List account fund recoveries [beta]"
method: GET
path: "/v1/pix/funds-recoveries"
tags: ["Funds recovery"]
---

# List account fund recoveries [beta]

`GET /v1/pix/funds-recoveries`

Get all fund recoveries for an account

## Query parameters

- `status` 'CREATED' | 'AWAITING_ANALYSIS' | 'TRACKED' | 'ANALYSED' | 'REFUNDING' | 'COMPLETED' | 'CANCELLED' — Funds recovery status: * `CREATED` - For `INTERACTIVE` * `AWAITING_ANALYSIS` - For `AUTOMATED` when processed synchronously * `CREATED` - Recovery created, awaiting next action. Both flows. * `TRACKED` - Tracking graph created. `INTERACTIVE` only * `AWAITING_ANALYSIS` - Awaiting analysis from receiver PSPs (deadline: 7 days). Both flows. * `ANALYSED` - Analysis completed, ready for refund. Both flows * `REFUNDING` - Refund process in progress. Both flows. * `COMPLETED` - Recovery successfully completed. Both flows. * `CANCELLED` - Recovery cancelled. Both flows.
- `modified_after` string, date-time
- `modified_before` string, date-time
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

OK - success

- ListAccountFundRecoveriesResponse
  - `has_more_elements` boolean — Are there more items?
  - `items` FundsRecovery[]
    - `id` string — Funds recovery identifier. Returned from the [Create funds recovery](https://developers.pismo.io/pismo-docs/reference/post-create-funds-recovery) endpoint.
    - `status` 'CREATED' | 'AWAITING_ANALYSIS' | 'TRACKED' | 'ANALYSED' | 'REFUNDING' | 'COMPLETED' | 'CANCELLED' — Funds recovery status: * `CREATED` - For `INTERACTIVE` * `AWAITING_ANALYSIS` - For `AUTOMATED` when processed synchronously * `CREATED` - Recovery created, awaiting next action. Both flows. * `TRACKED` - Tracking graph created. `INTERACTIVE` only * `AWAITING_ANALYSIS` - Awaiting analysis from receiver PSPs (deadline: 7 days). Both flows. * `ANALYSED` - Analysis completed, ready for refund. Both flows * `REFUNDING` - Refund process in progress. Both flows. * `COMPLETED` - Recovery successfully completed. Both flows. * `CANCELLED` - Recovery cancelled. Both flows.
    - `root_transaction_id` string — Fraudulent transaction end-to-end-id
    - `situation_type` 'SCAM' | 'ACCOUNT_TAKEOVER' | 'COERCION' | 'FRAUDULENT_ACCESS' | 'OTHER' | 'UNKNOWN' — Situation type: * `SCAM` - Scam/fraud through social engineering * `ACCOUNT_TAKEOVER` - Unauthorized transaction without digital authentication * `COERCION` - Coercion crime (kidnapping, extortion) * `FRAUDULENT_ACCESS` - Fraudulent access and authorization (phishing, stolen password) | * `OTHER` - Other cases. This option **REQUIRES** you pass `report_details`. * `UNKNOWN` - Unknown state
    - `reporter_participant` string — Reporter participant ID
    - `report_details` string — Details about report
    - `contact_information` ContactInformation
      - `phone` string, required — Contact phone number
      - `email` string, required — Contact email
    - `created_at` string, date-time — Creation datetime. A RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.
    - `updated_at` string, date-time — Updated datetime. A RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.

## Other responses

- `400` — Invalid funds recovery ID
- `403` — No permission
- `404` — Not found
- `504` — 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)