List DICT infractions

curl --request GET \
  --url https://spi.sandbox.lerian.net/api/v1/dict/infractions \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://spi.sandbox.lerian.net/api/v1/dict/infractions"

	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://spi.sandbox.lerian.net/api/v1/dict/infractions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "createdAt": "2026-06-14T12:00:00Z",
      "endToEndId": "E12345678202607101200D3E4F5A6B7C",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "reason": "REFUND_REQUEST",
      "reportStatus": "SENT",
      "reportedByISPB": "12345678",
      "situationType": "SCAM",
      "status": "OPEN",
      "updatedAt": "2026-06-14T12:00:00Z",
      "acknowledgedAt": "2026-06-20T10:00:00Z",
      "analysisDeadlineAt": "2026-06-21T12:00:00Z",
      "analysisDetails": "<string>",
      "analysisResult": "AGREED",
      "bacen": {
        "correlationId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
        "lastModified": "2026-06-14T12:00:00Z",
        "responseTime": "2026-06-14T12:00:00Z"
      },
      "bacenCreationTime": "2026-06-14T12:00:00Z",
      "contactInformation": {
        "email": "compliance@participant.example",
        "phone": "+5511999999999"
      },
      "counterpartyISPB": "87654321",
      "discoveredAt": "2026-06-20T09:00:00Z",
      "fraudMarkerId": "550e8400-e29b-41d4-a716-446655440002",
      "fundsRecoveryId": "550e8400-e29b-41d4-a716-446655440003",
      "infractionAmount": 1500,
      "originOperationId": "01930000-0000-7000-8000-000000000000",
      "reportDetails": "<string>",
      "reporterISPB": "12345678",
      "transactionDepth": 1
    }
  ],
  "limit": 123,
  "offset": 123,
  "requestId": "<string>"
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "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"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "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"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "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"
  }
}

GET

api

dict

infractions

List DICT infractions

curl --request GET \
  --url https://spi.sandbox.lerian.net/api/v1/dict/infractions \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://spi.sandbox.lerian.net/api/v1/dict/infractions"

	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://spi.sandbox.lerian.net/api/v1/dict/infractions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "createdAt": "2026-06-14T12:00:00Z",
      "endToEndId": "E12345678202607101200D3E4F5A6B7C",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "reason": "REFUND_REQUEST",
      "reportStatus": "SENT",
      "reportedByISPB": "12345678",
      "situationType": "SCAM",
      "status": "OPEN",
      "updatedAt": "2026-06-14T12:00:00Z",
      "acknowledgedAt": "2026-06-20T10:00:00Z",
      "analysisDeadlineAt": "2026-06-21T12:00:00Z",
      "analysisDetails": "<string>",
      "analysisResult": "AGREED",
      "bacen": {
        "correlationId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
        "lastModified": "2026-06-14T12:00:00Z",
        "responseTime": "2026-06-14T12:00:00Z"
      },
      "bacenCreationTime": "2026-06-14T12:00:00Z",
      "contactInformation": {
        "email": "compliance@participant.example",
        "phone": "+5511999999999"
      },
      "counterpartyISPB": "87654321",
      "discoveredAt": "2026-06-20T09:00:00Z",
      "fraudMarkerId": "550e8400-e29b-41d4-a716-446655440002",
      "fundsRecoveryId": "550e8400-e29b-41d4-a716-446655440003",
      "infractionAmount": 1500,
      "originOperationId": "01930000-0000-7000-8000-000000000000",
      "reportDetails": "<string>",
      "reporterISPB": "12345678",
      "transactionDepth": 1
    }
  ],
  "limit": 123,
  "offset": 123,
  "requestId": "<string>"
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "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"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "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"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "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"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de consulta

limit

integer<int64>

predeterminado:25

Page size (default 25, max 100)

Rango requerido: 1 <= x <= 100

offset

integer<int64>

predeterminado:0

Page offset (default 0)

Rango requerido: x >= 0

analysisStage

enum<string>

Narrows the page to one half of the DICT 8.4 §20.3 seven-day backlog: AWAITING_ACKNOWLEDGMENT (still OPEN, nobody has declared it received) or AWAITING_ANALYSIS_RESULT (acknowledged, analysis result not yet sent). Omit to cover both halves.

Opciones disponibles:

AWAITING_ACKNOWLEDGMENT,

AWAITING_ANALYSIS_RESULT

Ejemplo:

"AWAITING_ACKNOWLEDGMENT"

analysisDeadlineBefore

string<date-time>

Narrows the page to notifications whose seven-day analysis deadline falls at or before this instant, ordered most-overdue-first instead of newest-first. The deadline is counted from the moment the DICT made the notification available as OPEN (Manual de Tempos do Pix v7.0 §4.2.1.6). Pass the current instant for the ones already expired.

Ejemplo:

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

analysisDeadlineAfter

string<date-time>

Lower bound of the same seven-day window: drops notifications whose deadline is at or before this instant. Combine with analysisDeadlineBefore to page exactly one alarm gauge's rows — analysisDeadlineAfter=&analysisDeadlineBefore=<now+horizon> is the due-soon set alone, where an upper bound by itself returns every already-expired notification first and can push the actionable rows off the page.

Ejemplo:

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

Respuesta

items

object[]

requerido

Local DICT infraction records for the requested limit/offset window.

Show child attributes

limit

integer<int64>

requerido

Effective page size applied to this response.

offset

integer<int64>

requerido

Zero-based offset of the first item in this page.

requestId

string

Request-scoped identifier echoing X-Request-ID, for pivoting from response to trace. This is OUR OWN echo, distinct from any item's bacen.correlationId, which is BACEN's own value.