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"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Query Parameters

limit

integer<int64>

default:25

Page size (default 25, max 100)

Required range: 1 <= x <= 100

offset

integer<int64>

default:0

Page offset (default 0)

Required range: 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.

Available options:

AWAITING_ACKNOWLEDGMENT,

AWAITING_ANALYSIS_RESULT

Example:

"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.

Example:

"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.

Example:

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

Response

items

object[]

required

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

Show child attributes

limit

integer<int64>

required

Effective page size applied to this response.

offset

integer<int64>

required

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.