> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml en/openapi/v3-current/pix-lerian-dict.yaml GET /dict/infraction-reports/{id}/balance-blocks openapi: 3.1.0 info: contact: name: Lerian Studio url: https://lerian.studio description: >- Public API for Pix keys, claims, fraud markers, infraction reports, and MED funds recovery. license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license title: Pix Lerian — DICT version: release-candidate servers: - url: https://api.example.com/dict-hub/v1 description: >- Replace the example host with the URL provided during environment onboarding. security: - BearerAuth: [] tags: - description: Register, retrieve, list, update, and remove Pix keys. name: Entries - description: Look up Pix keys and check whether keys exist in the DICT directory. name: Keys - description: Manage ownership and portability claims for Pix keys. name: Claims - description: Manage participant-scoped MED 2.0 funds recoveries. name: Funds Recoveries - description: Manage MED 2.0 infraction reports for the authenticated organization. name: Infraction Reports - description: Create, query, cancel, and settle MED 2.0 refunds. name: Refunds - description: Create, query, list, and cancel DICT fraud markers. name: Fraud Markers paths: /dict/infraction-reports/{id}/balance-blocks: get: tags: - Infraction Reports summary: List balance blocks for an infraction report description: >- 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. operationId: listInfractionReportBalanceBlocks parameters: - description: Infraction report internal ID (UUID format) in: path name: id required: true schema: description: Infraction report internal ID (UUID format) examples: - 018f8c1d-1234-7abc-9def-000000000001 type: string example: 01960718-a213-2435-6078-901234567123 responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListBalanceBlocksOutput' examples: fictitiousExample: summary: Fictitious example value: 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' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error x-codeSamples: - lang: bash label: cURL with fictitious data source: |- 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' components: schemas: ListBalanceBlocksOutput: additionalProperties: false properties: infractionAmount: examples: - '1500.00' type: string items: items: $ref: '#/components/schemas/BalanceBlockOutput' type: - array - 'null' total: examples: - 1 format: int64 type: integer totalBlocked: examples: - '1000.00' type: string required: - items - total - totalBlocked type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object BalanceBlockOutput: additionalProperties: false properties: amount: examples: - '1000.00' type: string attemptNumber: examples: - 1 format: int64 type: integer createdAt: examples: - '2026-06-18T12:00:00Z' format: date-time type: string failureReason: examples: - balance-lock group settle exceeds the settle ceiling type: string id: examples: - 018f8c1d-1234-7abc-9def-000000000002 type: string spiBlockId: examples: - 018f8c1d-5678-7abc-9def-000000000003 type: string status: enum: - PENDING - SETTLING - SETTLED - RELEASED - FAILED examples: - PENDING type: string updatedAt: examples: - '2026-06-18T12:05:00Z' format: date-time type: string required: - id - amount - status - attemptNumber - createdAt - updatedAt type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````