Reconcile DICT keys against a BACEN event-list

CONTINGENCY reconciliation: reconciles an operator-supplied BACEN DICT event-list (CID) against local key state, flagging divergences. Used when the live CID/VSync inventory channel is unavailable. Enumeration/divergence only — no BACEN call, no money, no position.

POST /api/v1/dict/internal/reconciliation/run-events

Reconcile DICT keys against a BACEN event-list

cURL

curl --request POST \
  --url https://spi.sandbox.lerian.net/api/v1/dict/internal/reconciliation/run-events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "eventId": "<string>",
      "key": "<string>",
      "keyType": "<string>",
      "op": "<string>",
      "timestamp": "<string>"
    }
  ]
}
'

200

[
  {
    "discrepanciesDetected": 123,
    "id": "<string>",
    "keysChecked": 123,
    "mode": "<string>",
    "startedAt": "<string>",
    "status": "<string>",
    "discrepancies": [
      {
        "detectedAt": "<string>",
        "discrepancyType": "<string>",
        "keyValue": "<string>",
        "localStatus": "<string>",
        "remoteStatus": "<string>"
      }
    ],
    "finishedAt": "<string>"
  }
]

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Body

application/json

BACEN DICT event-list (CID) to reconcile against local key state; at least one event required

events · object[] | null · required

BACEN DICT event-list entries to reconcile against local key state; must contain at least one event.

Show child attributes

Response

200

application/json

object[] | null

OK

discrepanciesDetected · integer<int64> · required

Total count of discrepancies detected during the run.

Example:

2

id · string · required

Unique reconciliation run identifier (UUID).

Example:

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

keysChecked · integer<int64> · required

Number of keys checked against BACEN DICT during the run.

Example:

24

mode · string · required

Reconciliation mode the run executed with: FULL or INCREMENTAL.

Example:

"FULL"

startedAt · string · required

Timestamp the reconciliation run started, RFC 3339 (UTC).

Example:

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

status · string · required

Run lifecycle status: RUNNING, COMPLETED, or FAILED.

Example:

"COMPLETED"

discrepancies · object[] | null

Details of each detected discrepancy; omitted when none were found.

Show child attributes

finishedAt · string

Timestamp the run finished, RFC 3339 (UTC); omitted while the run is still RUNNING.

Example:

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