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

# Acknowledge an Infraction Report

> Use this endpoint to acknowledge receipt of an infraction report notification. This endpoint is used by the counterparty participant to acknowledge that they have received and are aware of the infraction report filed against a transaction. The report must be in OPEN status to be acknowledged. This operation is idempotent.



## OpenAPI

````yaml /pt/openapi/v3-current/indirect-pix.yaml post /v1/dict/infraction-reports/{infraction_id}/acknowledge
openapi: 3.1.0
info:
  description: >-
    API for Pix Indirect via BTG. It covers DICT keys and claims; MED infraction
    reports, fraud markers, refund requests, and funds recoveries; DICT
    statistics and reconciliation; Pix transfers, refunds, and schedules; static
    QR codes and QR code decoding; immediate and due-date collections; Pix
    Automático for the payer; transaction reports and TemposTransacoes
    statistics; and inbound and outbound webhook records.
  title: Pix BTG API
  version: 1.12.0
servers:
  - url: https://api.example.com
    description: >-
      Replace the example host with the URL provided during environment
      onboarding.
security:
  - BearerAuth: []
paths:
  /v1/dict/infraction-reports/{infraction_id}/acknowledge:
    post:
      tags:
        - Infraction Reports
      summary: Acknowledge an Infraction Report
      description: >-
        Use this endpoint to acknowledge receipt of an infraction report
        notification. This endpoint is used by the counterparty participant to
        acknowledge that they have received and are aware of the infraction
        report filed against a transaction. The report must be in OPEN status to
        be acknowledged. This operation is idempotent.
      operationId: dict-acknowledge-infraction-report
      parameters:
        - description: >-
            Unique identifier of the infraction report to acknowledge (UUID
            format)
          in: path
          name: infraction_id
          required: true
          schema:
            description: >-
              Unique identifier of the infraction report to acknowledge (UUID
              format)
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetInfractionReportOutput'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LegacyErrorBody'
          description: Bad Request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LegacyErrorBody'
          description: Internal Server Error
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LegacyErrorBody'
          description: Error
components:
  schemas:
    GetInfractionReportOutput:
      additionalProperties: false
      properties:
        accountId:
          description: Account ID (UUID)
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
          type: string
        analysisDetails:
          description: Detailed analysis from counterparty
          examples:
            - Analysis confirms fraudulent activity pattern
          type: string
        analysisResult:
          description: Analysis result from counterparty (if closed)
          enum:
            - AGREED
            - DISAGREED
          examples:
            - AGREED
          type: string
        bacenFundsRecoveryId:
          description: >-
            BACEN/BTG funds-recovery identifier linking this infraction to its
            MED Funds Recovery process
          examples:
            - 91d65e98-97c0-4b0f-b577-73625da1f9fc
          type: string
        bacenInfractionReportId:
          description: BACEN/BTG infraction report external identifier
          examples:
            - 91d65e98-97c0-4b0f-b577-73625da1f9fc
          type: string
        contactInformation:
          $ref: '#/components/schemas/ContactInformation'
          description: Contact information of the person reporting the fraud
        counterpartyParticipant:
          description: ISPB of the counterparty PSP involved in the transaction
          examples:
            - '87654321'
          type: string
        createdAt:
          description: Timestamp when the report was created (ISO 8601 UTC)
          examples:
            - '2023-11-07T05:31:56Z'
          format: date-time
          type: string
        fraudMarkerId:
          description: Unique fraud marker identifier from BACEN
          examples:
            - FM123456789
          type: string
        id:
          description: Unique identifier for the infraction report (UUID)
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
          type: string
        infractionAmount:
          description: Monetary amount of the infraction in BRL
          examples:
            - '1500.00'
          type: string
        reason:
          description: Report reason type
          examples:
            - REFUND_REQUEST
          type: string
        reportDetails:
          description: Detailed description of the fraud incident
          examples:
            - Customer reported receiving a call from fake bank employee
          type: string
        reporterParticipant:
          description: ISPB of the PSP reporting the infraction
          examples:
            - '12345678'
          type: string
        situationType:
          description: Type of fraud situation
          examples:
            - SCAM
          type: string
        status:
          description: Current status of the infraction report
          enum:
            - OPEN
            - ACKNOWLEDGED
            - CLOSED
            - CANCELLED
          examples:
            - OPEN
          type: string
        transactionDepth:
          description: >-
            Depth of the infraction's transaction in the DICT tracking graph
            (root = 1). Set by DICT; absent until DICT provides it.
          examples:
            - 1
          format: int64
          type: integer
        transactionId:
          description: PIX End-to-End transaction ID (32 alphanumeric characters)
          examples:
            - E12345678202411241430ABCDEFGHIJK
          type: string
        updatedAt:
          description: Timestamp when the report was last updated (ISO 8601 UTC)
          examples:
            - '2023-11-07T05:31:56Z'
          format: date-time
          type: string
      required:
        - id
        - bacenInfractionReportId
        - accountId
        - transactionId
        - reason
        - situationType
        - contactInformation
        - status
        - reporterParticipant
        - counterpartyParticipant
        - createdAt
        - updatedAt
      type: object
    LegacyErrorBody:
      additionalProperties: false
      properties:
        fields:
          additionalProperties:
            type: string
          type: object
        headers:
          additionalProperties:
            type: string
          type: object
        message:
          type: string
        paths:
          additionalProperties:
            type: string
          type: object
        queryParams:
          additionalProperties:
            type: string
          type: object
        raw:
          type: string
        code:
          type: string
        title:
          type: string
      required:
        - code
        - title
        - message
      type: object
    ContactInformation:
      additionalProperties: true
      properties:
        email:
          description: Email address of the customer reporting the fraud
          examples:
            - customer@example.com
          minLength: 1
          type: string
        phone:
          description: Phone number of the customer (E.164 format recommended)
          examples:
            - '+5511999999999'
          minLength: 1
          type: string
      required:
        - email
        - phone
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.