---
title: "Criar recuperação de valores"
method: POST
path: "/funds-recovery"
---

# Criar recuperação de valores

`POST /funds-recovery`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev/baas/v2`
- URL: `https://sandbox.openfinance.celcoin.dev/baas/v2/funds-recovery`
- Auth: OAuth 2

Confira nosso tutorial -> [Criar recuperação de valores](https://developers.celcoin.com.br/update/docs/criar-recupera%C3%A7%C3%A3o-de-valores-1)

## Request body

- object
  - `flowType` 'AUTOMATED', required: Tipo de fluxo de trabalho "AUTOMATED" é criado e gerenciado pelo DICT
  - `rootEndToEnd` string, required: Transação Raiz reportada como fraudulenta. (32 caracteres alfanuméricos)
  - `situationType` 'SCAM' | 'FRAUDULENT_ACCESS' | 'OTHER' | 'UNKNOWN' | 'UNAUTHORIZED_TRANSACTION' | 'COERCION', required: Tipo de situação que deu origem à Recuperação de Valores.
  - `reportDetails` string: Detalhes para ajudar na análise do PSP contraparte. Max. 2000 caracteres. Obrigatório se situationType = "OTHER".
  - `contactInformation` object, required: Informações de contato do PSP participante criador do registro.
    - `email` string
    - `phone` string
  - `trackingGraphParameters` object, required
    - `minTransactionAmount` number: Valor mínimo da transação para ser considerada e incluída no grafo de rastreamento.
    - `maxTransactions` integer: Número máximo de transações que o sistema deve rastrear. podendo ser de 1 a no máximo 5
    - `hopWindow` string: Janela de tempo (duração) máxima permitida entre a entrada de um valor em uma conta e sua saída para ser considerada como parte do fluxo fraudulento. Podendo ser no máximo até 2h.
    - `maxHops` integer: Profundidade máxima do grafo de rastreamento, ou seja, quantas "camadas" de contas o dinheiro pode passar a partir da transação raiz. Podendo ser no máximo = 2

## Response `200`

OK

- object
  - `status` integer
  - `version` string
  - `body` object
    - `fundsRecoveryId` string
    - `status` string
    - `flowType` string
    - `rootEndToEnd` string
    - `situationType` string
    - `reportDetails` string
    - `contactInformation` object
      - `email` string
      - `phone` string
    - `creationTime` string
    - `lastModified` string
    - `trackingGraph` object
      - `minTransactionAmount` integer
      - `maxTransactions` integer
      - `hopWindow` string
      - `maxHops` integer

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/celcoin/apis/baas-v2.md) - [All operations](https://skmtc.dev/celcoin/apis/baas-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/baas-v2/revisions/98ec6869c1f2?raw)