Como consultar uma recuperação de fundos (MED) usando a API?

Para consultar uma recuperação de fundos (MED) usando a API, você deverá fazer uma chamada GET para o endpoint /api/v1/funds-recovery/{id}, usando o dictId retornado na criação.

Use este endpoint para acompanhar o andamento da recuperação de fundos através do campo status — veja o ciclo de vida completo.

Exemplo

Se tudo ocorreu bem, o status code da requisição será 200 e no body da resposta retornaremos a recuperação de fundos:

{
  "rootTransactionId": "E31680151202606101530AbCdEf12345",
  "situationType": "SCAM",
  "reportDetails": "Pagamento realizado para um falso vendedor. Após o pagamento, o vendedor parou de responder e não entregou o produto.",
  "dictId": "3e760cd5-39b2-45da-8ab6-b212cf205568",
  "status": "AWAITING_ANALYSIS",
  "direction": "SENT",
  "reporterParticipant": "31680151",
  "creationTime": "2026-06-11T00:30:00.000Z",
  "lastModified": "2026-06-11T00:35:00.000Z",
  "events": [
    {
      "id": "f3a1c9d2-8b47-4e6a-9c21-5d7e0a4b8f13",
      "event": "AWAITING_ANALYSIS",
      "timestamp": "2026-06-11T00:35:00.000Z"
    }
  ],
  "createdAt": "2026-06-11T00:30:00.000Z",
  "updatedAt": "2026-06-11T00:35:00.000Z"
}

O campo events traz o histórico de eventos da recuperação de fundos, em ordem cronológica.

Possíveis erros

Status	Motivo
400	O id informado não é um UUID válido
401	AppID inválido ou ausente
403	Sua conta não possui a funcionalidade MED API ou o AppID não possui o escopo necessário
404	Recuperação de fundos não encontrada para a sua conta

Exemplos em código

Shell + cURL

curl --request GET \
    --url https://api.woovi.com/api/v1/funds-recovery/3e760cd5-39b2-45da-8ab6-b212cf205568 \
    --header 'Authorization: AUTHORIZATION'

JavaScript + Fetch

fetch(
  'https://api.woovi.com/api/v1/funds-recovery/3e760cd5-39b2-45da-8ab6-b212cf205568',
  {
    method: 'GET',
    headers: {
      Authorization: 'AUTHORIZATION',
    },
  },
).then((res) => res.json());