List balance blocks for an infraction report

Returns the balance blocks associated with an infraction report and the aggregate totals: infractionAmount from the parent report and totalBlocked, the effective amount retained across active blocks in PENDING, SETTLING, or SETTLED. The report must belong to the authenticated organization, otherwise 404 is returned.

GET /dict/infraction-reports/{id}/balance-blocks

cURL with fictitious data

cURL

curl --request GET \
  --url https://api.example.com/dict-hub/v1/dict/infraction-reports/01960718-a213-2435-6078-901234567123/balance-blocks \
  --header 'Authorization: Bearer demo-access-token'

200

{
  "infractionAmount": "1500.00",
  "items": [
    {
      "amount": "1000.00",
      "attemptNumber": 1,
      "createdAt": "2026-06-18T12:00:00Z",
      "failureReason": "balance-lock group settle exceeds the settle ceiling",
      "id": "018f8c1d-1234-7abc-9def-000000000002",
      "spiBlockId": "018f8c1d-5678-7abc-9def-000000000003",
      "status": "PENDING",
      "updatedAt": "2026-06-18T12:05:00Z"
    }
  ],
  "total": 1,
  "totalBlocked": "1000.00"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Path Parameters

id · string · required

Infraction report internal ID (UUID format)

Example:

"018f8c1d-1234-7abc-9def-000000000001"

Response

200

application/json

OK

items · object[] | null · required

Show child attributes

total · integer<int64> · required

Example:

1

totalBlocked · string · required

Example:

"1000.00"

infractionAmount · string

Example:

"1500.00"