cURL with fictitious data

curl --request POST \
  --url https://api.example.com/dict-hub/v1/dict/funds-recoveries \
  --header 'Authorization: Bearer demo-access-token' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: pix-demo-20260903-000001' \
  --data '{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "metadata": "metadata-example",
  "reportDetails": "Victim of a WhatsApp scam",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "trackingGraphParameters": "trackinggraphparameters-example"
}'

import requests

url = "https://api.example.com/dict-hub/v1/dict/funds-recoveries"

payload = {
    "accountId": "550e8400-e29b-41d4-a716-446655440000",
    "contactInformation": {
        "email": "user@example.com",
        "phone": "+5511999999999"
    },
    "metadata": "metadata-example",
    "reportDetails": "Victim of a WhatsApp scam",
    "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
    "situationType": "SCAM",
    "trackingGraphParameters": "trackinggraphparameters-example"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountId: '550e8400-e29b-41d4-a716-446655440000',
    contactInformation: {email: 'user@example.com', phone: '+5511999999999'},
    metadata: 'metadata-example',
    reportDetails: 'Victim of a WhatsApp scam',
    rootTransactionId: 'E12345678202605171530aB3xK9mWq2z',
    situationType: 'SCAM',
    trackingGraphParameters: 'trackinggraphparameters-example'
  })
};

fetch('https://api.example.com/dict-hub/v1/dict/funds-recoveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/dict-hub/v1/dict/funds-recoveries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accountId' => '550e8400-e29b-41d4-a716-446655440000',
    'contactInformation' => [
        'email' => 'user@example.com',
        'phone' => '+5511999999999'
    ],
    'metadata' => 'metadata-example',
    'reportDetails' => 'Victim of a WhatsApp scam',
    'rootTransactionId' => 'E12345678202605171530aB3xK9mWq2z',
    'situationType' => 'SCAM',
    'trackingGraphParameters' => 'trackinggraphparameters-example'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/dict-hub/v1/dict/funds-recoveries"

	payload := strings.NewReader("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/dict-hub/v1/dict/funds-recoveries")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/dict-hub/v1/dict/funds-recoveries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}"

response = http.request(request)
puts response.read_body

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenFundsRecoveryId": "9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "correlationId": "7c9e6679742540de944be07fc1f90ae7",
  "createdAt": "2026-05-17T13:30:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "metadata": "metadata-example",
  "participantId": "12345678",
  "reportDetails": "Victim of a WhatsApp scam",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": "trackinggraph-example",
  "trackingGraphParameters": "trackinggraphparameters-example",
  "updatedAt": "2026-05-17T13:30:00Z"
}

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenFundsRecoveryId": "9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "correlationId": "7c9e6679742540de944be07fc1f90ae7",
  "createdAt": "2026-05-17T13:30:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "metadata": "metadata-example",
  "participantId": "12345678",
  "reportDetails": "Victim of a WhatsApp scam",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": "trackinggraph-example",
  "trackingGraphParameters": "trackinggraphparameters-example",
  "updatedAt": "2026-05-17T13:30:00Z"
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Create a funds recovery

Opens a MED 2.0 funds recovery synchronously. A successful creation returns HTTP 201 with status CREATED. Reusing an Idempotency-Key returns the original response with HTTP 200. A duplicate recovery is rejected with 409 / PIX-0113. If the timestamp in rootTransactionId is outside the applicable MED contestation window, the request is rejected with 422 / PIX-0117. The window is determined by the funds recovery creation time: pacs.008 uses 80 calendar days; pacs.004 uses 30 calendar days before 2026-09-01T00:00:00Z and 80 calendar days from that instant onward. This timestamp validation does not confirm that the referenced transaction exists. The participant is determined by the authenticated tenant. participantId, reporterParticipant, rootTransactionType, and idempotencyKey are rejected when included in the body.

POST

dict

funds-recoveries

cURL with fictitious data

curl --request POST \
  --url https://api.example.com/dict-hub/v1/dict/funds-recoveries \
  --header 'Authorization: Bearer demo-access-token' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: pix-demo-20260903-000001' \
  --data '{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "metadata": "metadata-example",
  "reportDetails": "Victim of a WhatsApp scam",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "trackingGraphParameters": "trackinggraphparameters-example"
}'

import requests

url = "https://api.example.com/dict-hub/v1/dict/funds-recoveries"

payload = {
    "accountId": "550e8400-e29b-41d4-a716-446655440000",
    "contactInformation": {
        "email": "user@example.com",
        "phone": "+5511999999999"
    },
    "metadata": "metadata-example",
    "reportDetails": "Victim of a WhatsApp scam",
    "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
    "situationType": "SCAM",
    "trackingGraphParameters": "trackinggraphparameters-example"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountId: '550e8400-e29b-41d4-a716-446655440000',
    contactInformation: {email: 'user@example.com', phone: '+5511999999999'},
    metadata: 'metadata-example',
    reportDetails: 'Victim of a WhatsApp scam',
    rootTransactionId: 'E12345678202605171530aB3xK9mWq2z',
    situationType: 'SCAM',
    trackingGraphParameters: 'trackinggraphparameters-example'
  })
};

fetch('https://api.example.com/dict-hub/v1/dict/funds-recoveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/dict-hub/v1/dict/funds-recoveries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accountId' => '550e8400-e29b-41d4-a716-446655440000',
    'contactInformation' => [
        'email' => 'user@example.com',
        'phone' => '+5511999999999'
    ],
    'metadata' => 'metadata-example',
    'reportDetails' => 'Victim of a WhatsApp scam',
    'rootTransactionId' => 'E12345678202605171530aB3xK9mWq2z',
    'situationType' => 'SCAM',
    'trackingGraphParameters' => 'trackinggraphparameters-example'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/dict-hub/v1/dict/funds-recoveries"

	payload := strings.NewReader("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/dict-hub/v1/dict/funds-recoveries")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/dict-hub/v1/dict/funds-recoveries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}"

response = http.request(request)
puts response.read_body

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenFundsRecoveryId": "9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "correlationId": "7c9e6679742540de944be07fc1f90ae7",
  "createdAt": "2026-05-17T13:30:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "metadata": "metadata-example",
  "participantId": "12345678",
  "reportDetails": "Victim of a WhatsApp scam",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": "trackinggraph-example",
  "trackingGraphParameters": "trackinggraphparameters-example",
  "updatedAt": "2026-05-17T13:30:00Z"
}

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenFundsRecoveryId": "9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "correlationId": "7c9e6679742540de944be07fc1f90ae7",
  "createdAt": "2026-05-17T13:30:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "metadata": "metadata-example",
  "participantId": "12345678",
  "reportDetails": "Victim of a WhatsApp scam",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": "trackinggraph-example",
  "trackingGraphParameters": "trackinggraphparameters-example",
  "updatedAt": "2026-05-17T13:30:00Z"
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Headers

Idempotency-Key

string

required

Client-generated key used to retry exactly the same request safely.

Example:

"a1b2c3d4-0000-0000-0000-000000000001"

Body

application/json

accountId

string

required

Example:

"550e8400-e29b-41d4-a716-446655440000"

contactInformation

object

required

Show child attributes

rootTransactionId

string

required

Example:

"E12345678202605171530aB3xK9mWq2z"

situationType

enum<string>

required

Available options:

SCAM,

ACCOUNT_TAKEOVER,

COERCION,

FRAUDULENT_ACCESS,

OTHER,

UNKNOWN

Example:

"SCAM"

metadata

any

reportDetails

string

Example:

"Victim of a WhatsApp scam"

trackingGraphParameters

any

Response

Idempotent replay: a repeated Idempotency-Key returns the funds recovery created by the first request (cached response body).

accountId

string

required

Example:

"550e8400-e29b-41d4-a716-446655440000"

bacenFundsRecoveryId

string

required

Example:

"9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f"

contactInformation

object

required

Show child attributes

createdAt

string<date-time>

required

Example:

"2026-05-17T13:30:00Z"

string

required

Example:

"018f8c1d-1234-7abc-9def-000000000001"

participantId

string

required

Example:

"12345678"

reporterParticipant

string

required

Example:

"12345678"

rootTransactionId

string

required

Example:

"E12345678202605171530aB3xK9mWq2z"

situationType

enum<string>

required

Available options:

SCAM,

ACCOUNT_TAKEOVER,

COERCION,

FRAUDULENT_ACCESS,

OTHER,

UNKNOWN

Example:

"SCAM"

status

enum<string>

required

Available options:

CREATED,

TRACKED,

AWAITING_ANALYSIS,

ANALYSED,

REFUNDING,

COMPLETED,

CANCELLED

Example:

"CREATED"

updatedAt

string<date-time>

required

Example:

"2026-05-17T13:30:00Z"

correlationId

string

Example:

"7c9e6679742540de944be07fc1f90ae7"

metadata

any

reportDetails

string

Example:

"Victim of a WhatsApp scam"

trackingGraph

any

trackingGraphParameters

any

Pix — Lerian SPI (native messaging)

Pix Lerian

Pix — JD (interface, direct)

Pix — BTG (interface, indirect)

TED — Lerian SPB (native messaging)

TED — JD (interface)

Boletos — BTG (interface)

Lerian SILOC (native messaging)

Lerian SLC (native messaging)

Lerian STA (native messaging)

Lerian SISBAJUD (native messaging)

Lerian Consignado — Dataprev

Create a funds recovery

Authorizations

Headers

Body

Response