Retrieve Infraction Report details

curl --request GET \
  --url https://api.example.com/v1/dict/infraction-reports/{infraction_id} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/v1/dict/infraction-reports/{infraction_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))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/v1/dict/infraction-reports/{infraction_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/dict/infraction-reports/{infraction_id}"

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

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

print(response.text)

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenInfractionReportId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "contactInformation": {
    "email": "customer@example.com",
    "phone": "+5511999999999"
  },
  "counterpartyParticipant": "87654321",
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "REFUND_REQUEST",
  "reporterParticipant": "12345678",
  "situationType": "SCAM",
  "status": "OPEN",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "updatedAt": "2023-11-07T05:31:56Z",
  "analysisDetails": "Analysis confirms fraudulent activity pattern",
  "analysisResult": "AGREED",
  "bacenFundsRecoveryId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "fraudMarkerId": "FM123456789",
  "infractionAmount": "1500.00",
  "reportDetails": "Customer reported receiving a call from fake bank employee",
  "transactionDepth": 1
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

GET

dict

infraction-reports

{infraction_id}

Retrieve Infraction Report details

curl --request GET \
  --url https://api.example.com/v1/dict/infraction-reports/{infraction_id} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/v1/dict/infraction-reports/{infraction_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))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/v1/dict/infraction-reports/{infraction_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/dict/infraction-reports/{infraction_id}"

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

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

print(response.text)

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenInfractionReportId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "contactInformation": {
    "email": "customer@example.com",
    "phone": "+5511999999999"
  },
  "counterpartyParticipant": "87654321",
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "REFUND_REQUEST",
  "reporterParticipant": "12345678",
  "situationType": "SCAM",
  "status": "OPEN",
  "transactionId": "E12345678202411241430ABCDEFGHIJK",
  "updatedAt": "2023-11-07T05:31:56Z",
  "analysisDetails": "Analysis confirms fraudulent activity pattern",
  "analysisResult": "AGREED",
  "bacenFundsRecoveryId": "91d65e98-97c0-4b0f-b577-73625da1f9fc",
  "fraudMarkerId": "FM123456789",
  "infractionAmount": "1500.00",
  "reportDetails": "Customer reported receiving a call from fake bank employee",
  "transactionDepth": 1
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "fields": {},
  "headers": {},
  "paths": {},
  "queryParams": {},
  "raw": "<string>"
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

infraction_id

string<uuid>

requerido

Unique identifier of the infraction report (UUID format)

Respuesta

accountId

string

requerido

Account ID (UUID) of the contested Pix transfer when the report arrived through BTG; empty when it was opened through this API

Ejemplo:

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

bacenInfractionReportId

string

requerido

BACEN/BTG infraction report external identifier

Ejemplo:

"91d65e98-97c0-4b0f-b577-73625da1f9fc"

contactInformation

object

requerido

Contact information of the person reporting the fraud

Show child attributes

counterpartyParticipant

string

requerido

ISPB of the counterparty PSP involved in the transaction

Ejemplo:

"87654321"

createdAt

string<date-time>

requerido

Timestamp when the report was created (ISO 8601 UTC)

Ejemplo:

"2023-11-07T05:31:56Z"

string

requerido

Unique identifier for the infraction report (UUID)

Ejemplo:

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

reason

string

requerido

Report reason type

Ejemplo:

"REFUND_REQUEST"

reporterParticipant

string

requerido

ISPB of the PSP reporting the infraction

Ejemplo:

"12345678"

situationType

string

requerido

Type of fraud situation

Ejemplo:

"SCAM"

status

enum<string>

requerido

Current status of the infraction report

Opciones disponibles:

OPEN,

ACKNOWLEDGED,

CLOSED,

CANCELLED

Ejemplo:

"OPEN"

transactionId

string

requerido

PIX End-to-End transaction ID (32 alphanumeric characters)

Ejemplo:

"E12345678202411241430ABCDEFGHIJK"

updatedAt

string<date-time>

requerido

Timestamp when the report was last updated (ISO 8601 UTC)

Ejemplo:

"2023-11-07T05:31:56Z"

analysisDetails

string

Detailed analysis from counterparty

Ejemplo:

"Analysis confirms fraudulent activity pattern"

analysisResult

enum<string>

Analysis result from counterparty (if closed)

Opciones disponibles:

AGREED,

DISAGREED

Ejemplo:

"AGREED"

bacenFundsRecoveryId

string

BACEN/BTG funds-recovery identifier linking this infraction to its MED Funds Recovery process

Ejemplo:

"91d65e98-97c0-4b0f-b577-73625da1f9fc"

fraudMarkerId

string

Unique fraud marker identifier from BACEN

Ejemplo:

"FM123456789"

infractionAmount

string

Monetary amount of the infraction in BRL

Ejemplo:

"1500.00"

reportDetails

string

Detailed description of the fraud incident

Ejemplo:

"Customer reported receiving a call from fake bank employee"

transactionDepth

integer<int64>

Depth of the infraction's transaction in the DICT tracking graph (root = 1). Set by DICT; absent until DICT provides it.

Ejemplo:

1

API de DICT

API de Reclamaciones

MED · Infracciones

MED · Marcadores de fraude

MED · Solicitudes de devolución

MED · Estadísticas

API de Transacciones

API de Códigos QR

API de Cobros

API de Recuperación de Fondos

API de Conciliación

API de Pix Automático

API de Programaciones

API de Informes de Transacción

Tiempos de transacciones

API de Webhooks

Manejo de errores

Eventos

Retrieve Infraction Report details

Autorizaciones

Parámetros de ruta

Respuesta