Pular para o conteúdo principal
GET
/
api
/
v1
/
dict
/
fraud-markers
/
{id}
Obter marcador de fraude
curl --request GET \
  --url https://spi.sandbox.lerian.net/api/v1/dict/fraud-markers/{id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://spi.sandbox.lerian.net/api/v1/dict/fraud-markers/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://spi.sandbox.lerian.net/api/v1/dict/fraud-markers/{id}', 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://spi.sandbox.lerian.net/api/v1/dict/fraud-markers/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

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

curl_close($curl);

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

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

func main() {

url := "https://spi.sandbox.lerian.net/api/v1/dict/fraud-markers/{id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

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

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

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://spi.sandbox.lerian.net/api/v1/dict/fraud-markers/{id}")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://spi.sandbox.lerian.net/api/v1/dict/fraud-markers/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "createdAt": "<string>",
  "id": "<string>",
  "keyValueHash": "<string>",
  "participantISPB": "<string>",
  "reason": "<string>",
  "reportStatus": "<string>",
  "status": "<string>",
  "updatedAt": "<string>",
  "ownerTaxIdHash": "<string>"
}
{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "about:blank"
}

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Parâmetros de caminho

id
string
obrigatório

Fraud marker UUID

Resposta

OK

Persisted minimized fraud marker (PII stored only as hashes)

createdAt
string
obrigatório

Record creation timestamp (RFC 3339, UTC)

Exemplo:

"2026-06-14T12:00:00Z"

id
string
obrigatório

Server-assigned fraud-marker record UUID

Exemplo:

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

keyValueHash
string
obrigatório

HMAC hash of the marked PIX key value (hex); the plaintext key is never returned

Exemplo:

"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

participantISPB
string
obrigatório

ISPB (8 numeric digits) of the participant that raised the fraud marker

Exemplo:

"12345678"

reason
string
obrigatório

Free-text justification for the fraud marker

reportStatus
string
obrigatório

BACEN report delivery state: PENDING, SENT, or FAILED (FAILED is retryable; the local record stands)

Exemplo:

"SENT"

status
string
obrigatório

Local fraud-marker state: ACTIVE (counts toward fraud stats) or INACTIVE (retained for audit only)

Exemplo:

"ACTIVE"

updatedAt
string
obrigatório

Last update timestamp (RFC 3339, UTC)

Exemplo:

"2026-06-14T12:00:00Z"

ownerTaxIdHash
string

HMAC hash of the owner tax ID (hex); omitted when no tax ID was supplied

Exemplo:

"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"