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

# Get funds recovery [beta]

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

Get a funds recovery.

Customers should use this endpoint to monitor and track progress, such as checking status after asynchronous operations or audit closed cases.

## Path parameters

- `funds_recovery_id` string, required

## Query parameters

- `useProvider` boolean

## Response `200`

OK - success

- CreateFundsRecoveryResponse — Create funds recovery request
  - `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
  - `contact_information` ContactInformation
    - `phone` string, required — Contact phone number
    - `email` string, required — Contact email
  - `report_details` string — Details about report
  - `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)