Get a FundsRecovery record by ID

​

Retrieves a single PIX MED FundsRecovery record by UUID. Access is scoped to records where the local PSP is the reporter. Bacen citation: DICT API v2.10.1 §4.2.4 (mgmt/bacen-docs/med/Guia_MED.pdf, SHA256:d9daabc5).

Path Parameters
  • id
    Type: string Format: uuid
    required

    UUID of the FundsRecovery record to retrieve

Responses
  • application/json
  • 400

    Invalid request

    Erros desta resposta

    Código interno HTTP Descrição Erro normativo Bacen
    GLOBAL-0000 400 Request validation failed and the violated rule declares no specific code BadRequest
    MED-0041 400 Request body contains invalid JSON or an unsupported field value BadRequest
  • application/json
  • application/json
Request Example for get/api/v1/funds-recovery/{id}
curl http://localhost/api/v1/funds-recovery/123e4567-e89b-12d3-a456-426614174000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "transactionId": "string",
  "status": "CREATED",
  "participantIspb": "string",
  "situationType": "SCAM",
  "reportDetails": null,
  "contactEmail": null,
  "contactPhone": null,
  "trackingParameters": {
    "minTransactionAmount": 0.01,
    "maxTransactions": 1,
    "hopWindow": "PT2H",
    "maxHops": 1
  },
  "effectiveRefundedAmount": null,
  "createdAt": "2026-09-16T19:14:18.843Z",
  "lastModified": "2026-09-16T19:14:18.843Z"
}

FundsRecovery record retrieved successfully.