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

# Obter um relato de infração

> Obtém um relato de infração por seu ID de recurso (UUID v7), incluindo seus bloqueios de saldo associados, dentro do escopo da organização autenticada. Retorna 404 quando nenhum relato com esse ID pertence à organização. Um relato pertencente a outra organização produz a mesma resposta que um ID desconhecido.



## OpenAPI

````yaml pt/openapi/v3-current/pix-lerian-dict.yaml GET /dict/infraction-reports/{id}
openapi: 3.1.0
info:
  contact:
    name: Lerian Studio
    url: https://lerian.studio
  description: >-
    API pública para chaves Pix, reivindicações, marcadores de fraude, relatos
    de infração e recuperação de valores do MED.
  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: Substitua o host de exemplo pela URL fornecida no onboarding do ambiente.
security:
  - BearerAuth: []
tags:
  - description: Registro, consulta, listagem, atualização e remoção de chaves Pix.
    name: Entries
  - description: Consulta de chaves Pix e verificação de existência no diretório DICT.
    name: Keys
  - description: Gestão de reivindicações de posse e portabilidade de chaves Pix.
    name: Claims
  - description: Gestão de recuperações de valores do MED 2.0 no escopo do participante.
    name: Funds Recoveries
  - description: Gestão de relatos de infração do MED 2.0 para a organização autenticada.
    name: Infraction Reports
  - description: Criação, consulta, cancelamento e liquidação de devoluções do MED 2.0.
    name: Refunds
  - description: >-
      Criação, consulta, listagem e cancelamento de marcadores de fraude do
      DICT.
    name: Fraud Markers
paths:
  /dict/infraction-reports/{id}:
    get:
      tags:
        - Infraction Reports
      summary: Obter um relato de infração
      description: >-
        Obtém um relato de infração por seu ID de recurso (UUID v7), incluindo
        seus bloqueios de saldo associados, dentro do escopo da organização
        autenticada. Retorna 404 quando nenhum relato com esse ID pertence à
        organização. Um relato pertencente a outra organização produz a mesma
        resposta que um ID desconhecido.
      operationId: getInfractionReport
      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/InfractionReportDetailOutput'
              examples:
                exemploFicticio:
                  summary: Exemplo fictício
                  value:
                    analysisDetails: Mule account confirmed by anti-fraud analysis.
                    analysisResult: AGREED
                    bacenFundsRecoveryId: 018f8c1d-1111-7abc-9def-000000000001
                    bacenInfractionReportId: 018f8c1d-aaaa-7abc-9def-000000000010
                    balanceBlocks:
                      - 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'
                    contactInformation:
                      email: user@example.com
                      phone: '+5511999999999'
                    correlationId: 9f3a8b7e2c1d4e5a8b6f1a2b3c4d5e6f
                    counterpartyParticipant: '87654321'
                    createdAt: '2026-06-18T12:00:00Z'
                    fraudMarkerId: 018f8c1d-bbbb-7abc-9def-000000000020
                    fraudType: MULE_ACCOUNT
                    id: 018f8c1d-1234-7abc-9def-000000000001
                    infractionAmount: '1500.00'
                    monitorAccount: false
                    reportDetails: conta usada repetidamente em golpes
                    reporterParticipant: '12345678'
                    situationType: SCAM
                    status: OPEN
                    transactionDepth: 1
                    transactionId: E12345678202601011200abcdef01234
                    updatedAt: '2026-06-18T12:05:00Z'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
      x-codeSamples:
        - lang: bash
          label: cURL com dados fictícios
          source: |-
            curl --request GET \
              --url https://api.example.com/dict-hub/v1/dict/infraction-reports/01960718-a213-2435-6078-901234567123 \
              --header 'Authorization: Bearer demo-access-token'
components:
  schemas:
    InfractionReportDetailOutput:
      additionalProperties: false
      properties:
        analysisDetails:
          examples:
            - Mule account confirmed by anti-fraud analysis.
          type: string
        analysisResult:
          enum:
            - AGREED
            - DISAGREED
          examples:
            - AGREED
          type: string
        bacenFundsRecoveryId:
          examples:
            - 018f8c1d-1111-7abc-9def-000000000001
          type: string
        bacenInfractionReportId:
          examples:
            - 018f8c1d-aaaa-7abc-9def-000000000010
          type: string
        balanceBlocks:
          items:
            $ref: '#/components/schemas/BalanceBlockOutput'
          type:
            - array
            - 'null'
        contactInformation:
          $ref: '#/components/schemas/ContactInformationOutput'
        correlationId:
          examples:
            - 9f3a8b7e2c1d4e5a8b6f1a2b3c4d5e6f
          type: string
        counterpartyParticipant:
          examples:
            - '87654321'
          type: string
        createdAt:
          examples:
            - '2026-06-18T12:00:00Z'
          format: date-time
          type: string
        fraudMarkerId:
          examples:
            - 018f8c1d-bbbb-7abc-9def-000000000020
          type: string
        fraudType:
          enum:
            - APPLICATION_FRAUD
            - MULE_ACCOUNT
            - SCAMMER_ACCOUNT
            - OTHER
          examples:
            - MULE_ACCOUNT
          type: string
        id:
          examples:
            - 018f8c1d-1234-7abc-9def-000000000001
          type: string
        infractionAmount:
          examples:
            - '1500.00'
          type: string
        monitorAccount:
          examples:
            - false
          type: boolean
        reportDetails:
          examples:
            - conta usada repetidamente em golpes
          type: string
        reporterParticipant:
          examples:
            - '12345678'
          type: string
        situationType:
          enum:
            - SCAM
            - ACCOUNT_TAKEOVER
            - COERCION
            - FRAUDULENT_ACCESS
            - OTHER
            - UNKNOWN
          examples:
            - SCAM
          type: string
        status:
          enum:
            - OPEN
            - ACKNOWLEDGED
            - CLOSED
            - CANCELLED
          examples:
            - OPEN
          type: string
        transactionDepth:
          examples:
            - 1
          format: int64
          maximum: 2147483647
          minimum: 1
          type: integer
        transactionId:
          examples:
            - E12345678202601011200abcdef01234
          type: string
        updatedAt:
          examples:
            - '2026-06-18T12:05:00Z'
          format: date-time
          type: string
      required:
        - id
        - bacenInfractionReportId
        - transactionId
        - situationType
        - contactInformation
        - status
        - balanceBlocks
        - monitorAccount
        - createdAt
        - updatedAt
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-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
    ContactInformationOutput:
      additionalProperties: false
      properties:
        email:
          examples:
            - user@example.com
          type: string
        phone:
          examples:
            - '+5511999999999'
          type: string
      required:
        - email
        - phone
      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

````