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

# Get the APIX001 report of a closed reference month

> Returns the current report of the month in the `period` query parameter: the ten blocks of the APIX001 layout for the ISPB of the tenant, in layout order and with the fixed rows of the layout, zero rows included. Every indicator and block carries `coverage`, so a `0.00` that is a filler is never read as a measured zero. A block that Pix Lerian does not compute comes back `UNAVAILABLE` with a reason, never omitted. A time indicator is in seconds, except `maxCautionaryBlockTime`, in hours.

A month never closed, or reopened and not closed again, answers `404` (`PIX-0711`): close it first. A future month answers `422` (`PIX-0710`). A `period` that is absent or not `YYYY-MM` answers `400` (`PIX-0020`), and a month before 2020-11 answers `400` (`PIX-0003`). The month state is read on the read replica, and on the primary when none is configured, so a reopen or a new close is visible once the replica has applied it. The close response already carries the report.



## OpenAPI

````yaml /pt/openapi/v3-current/pix-lerian-spi.yaml get /regulatory/apix001/report
openapi: 3.1.0
info:
  contact:
    name: Lerian Studio
    url: https://lerian.studio
  description: Public API for outbound Pix transfers, refunds, and scheduled payments.
  license:
    name: Lerian Studio General License
  title: Pix Lerian — Payments
  version: 1.5.0
servers:
  - url: https://api.example.com/spi/v1
    description: >-
      Replace the example host with the URL provided during environment
      onboarding.
security:
  - BearerAuth: []
tags:
  - description: Create, list, and retrieve Pix refunds.
    name: Refunds
  - name: Scheduled Payments
    description: Register, list, retrieve, and cancel scheduled Pix payments.
  - description: >-
      Initiate, process, list, and retrieve outbound Pix transfers, and cancel
      or decide a sent Pix held in fraud analysis.
    name: Transfers
  - description: >-
      Register, list, retrieve, and cancel recurring series of scheduled Pix
      payments.
    name: Scheduled Payment Recurrences
  - description: >-
      Hold the funds of a received Pix in a cautionary block (MED 2.0), return
      them to the payer, or give them back to the account holder.
    name: Balance Locks
  - description: Read the APIX001 report of a closed month.
    name: APIX001 Reports
  - description: Close a reference month into an immutable report, and reopen it.
    name: APIX001 Periods
  - description: >-
      Record and correct the facts that only the participant knows, for the
      APIX001 report.
    name: APIX Client Facts
  - description: >-
      Declare the indirect participants that the tenant settles for, and end the
      declarations.
    name: APIX Settled Participants
paths:
  /regulatory/apix001/report:
    get:
      tags:
        - APIX001 Reports
      summary: Get the APIX001 report of a closed reference month
      description: >-
        Returns the current report of the month in the `period` query parameter:
        the ten blocks of the APIX001 layout for the ISPB of the tenant, in
        layout order and with the fixed rows of the layout, zero rows included.
        Every indicator and block carries `coverage`, so a `0.00` that is a
        filler is never read as a measured zero. A block that Pix Lerian does
        not compute comes back `UNAVAILABLE` with a reason, never omitted. A
        time indicator is in seconds, except `maxCautionaryBlockTime`, in hours.


        A month never closed, or reopened and not closed again, answers `404`
        (`PIX-0711`): close it first. A future month answers `422` (`PIX-0710`).
        A `period` that is absent or not `YYYY-MM` answers `400` (`PIX-0020`),
        and a month before 2020-11 answers `400` (`PIX-0003`). The month state
        is read on the read replica, and on the primary when none is configured,
        so a reopen or a new close is visible once the replica has applied it.
        The close response already carries the report.
      operationId: getApix001Report
      parameters:
        - description: >-
            Reference month, YYYY-MM. Absent or not YYYY-MM is 400 PIX-0020; a
            month before 2020-11, when Pix started, is 400 PIX-0003; a month in
            the future is 422 PIX-0710.
          explode: false
          in: query
          name: period
          required: true
          schema:
            description: >-
              Reference month, YYYY-MM. Absent or not YYYY-MM is 400 PIX-0020; a
              month before 2020-11, when Pix started, is 400 PIX-0003; a month
              in the future is 422 PIX-0710.
            examples:
              - 2026-10
            pattern: ^[0-9]{4}-(0[1-9]|1[0-2])$
            type: string
      responses:
        '200':
          content:
            application/json:
              example:
                reportId: 0193a6f0-7c1e-7b4a-9d2e-5f6a7b8c9d0e
                period: 2026-10
                ispb: '12345678'
                layoutVersion: '2.7'
                blocks:
                  transactions:
                    rows:
                      - transactionDetail: 5
                        transactionPurpose: 1
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 5
                        transactionPurpose: 2
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 5
                        transactionPurpose: 3
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 5
                        transactionPurpose: 4
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 6
                        transactionPurpose: 1
                        transactionCount: 1
                        transactionAmount: '150.00'
                        cashAmount: '0.00'
                      - transactionDetail: 6
                        transactionPurpose: 2
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 6
                        transactionPurpose: 3
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 6
                        transactionPurpose: 4
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 7
                        transactionPurpose: 1
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 7
                        transactionPurpose: 2
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 7
                        transactionPurpose: 3
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                      - transactionDetail: 7
                        transactionPurpose: 4
                        transactionCount: 0
                        transactionAmount: '0.00'
                        cashAmount: '0.00'
                    detailCoverage:
                      - transactionDetail: 5
                        coverage:
                          status: NOT_APPLICABLE
                          reason: >-
                            no indirect participant declaration valid in the
                            month
                      - transactionDetail: 6
                        coverage:
                          status: COMPLETE
                      - transactionDetail: 7
                        coverage:
                          status: UNAVAILABLE
                          reason: no outbound fraud refusal informed for the month
                  refunds:
                    rows:
                      - refundDetail: 1
                        refundCount: 0
                        refundAmount: '0.00'
                      - refundDetail: 2
                        refundCount: 1
                        refundAmount: '89.90'
                    coverage:
                      status: COMPLETE
                  cautionaryBlocks:
                    rows:
                      - cautionaryBlockDetail: 1
                        cautionaryBlockCount: 0
                        cautionaryBlockAmount: '0.00'
                      - cautionaryBlockDetail: 2
                        cautionaryBlockCount: 0
                        cautionaryBlockAmount: '0.00'
                      - cautionaryBlockDetail: 3
                        cautionaryBlockCount: 0
                        cautionaryBlockAmount: '0.00'
                      - cautionaryBlockDetail: 4
                        cautionaryBlockCount: 0
                        cautionaryBlockAmount: '0.00'
                    coverage:
                      status: UNAVAILABLE
                      reason: not computed by Pix Lerian
                  revenues:
                    rows:
                      - revenueSource: 1
                        revenueAmount: '0.00'
                      - revenueSource: 2
                        revenueAmount: '0.00'
                      - revenueSource: 3
                        revenueAmount: '0.00'
                      - revenueSource: 4
                        revenueAmount: '0.00'
                    coverage:
                      status: UNAVAILABLE
                      reason: not computed by Pix Lerian
                  transactionTimes:
                    p50SpiUserExperienceTime:
                      value: '2.84'
                      coverage:
                        status: PARTIAL
                        reason: >-
                          measured from the client call to the result delivery;
                          ends before t6a (Manual de Tempos v7.0 4.1.2)
                    p99SpiUserExperienceTime:
                      value: '7.91'
                      coverage:
                        status: PARTIAL
                        reason: >-
                          measured from the client call to the result delivery;
                          ends before t6a (Manual de Tempos v7.0 4.1.2)
                    p50OutsideSpiUserExperienceTime:
                      value: '1.37'
                      coverage:
                        status: COMPLETE
                    p99OutsideSpiUserExperienceTime:
                      value: '1.37'
                      coverage:
                        status: COMPLETE
                    maxCautionaryBlockTime:
                      value: '0.00'
                      coverage:
                        status: UNAVAILABLE
                        reason: not computed by Pix Lerian
                  dictTimes:
                    p99KeyLookupTime:
                      value: '0.42'
                      coverage:
                        status: PARTIAL
                        reason: >-
                          lower bound: only the DICT hub call inside the
                          initiate is measured, not the participant channel nor
                          the rest of the initiate; a key lookup the client
                          makes before the initiate is not seen; lookups that
                          failed technically (timeout, connection, 5xx) are left
                          out; negative answers are not measured; Pix Agendado
                          key lookups are not measured
                    p95KeyRegistrationCodeSendTime:
                      value: '0.00'
                      coverage:
                        status: UNAVAILABLE
                        reason: not computed by Pix Lerian
                    p95KeyRegistrationUserExperienceTime:
                      value: '0.00'
                      coverage:
                        status: UNAVAILABLE
                        reason: not computed by Pix Lerian
                    p95KeyDeletionUserExperienceTime:
                      value: '0.00'
                      coverage:
                        status: UNAVAILABLE
                        reason: not computed by Pix Lerian
                    p95PortabilityNotificationTime:
                      value: '0.00'
                      coverage:
                        status: UNAVAILABLE
                        reason: not computed by Pix Lerian
                    p95PortabilitySendTime:
                      value: '0.00'
                      coverage:
                        status: UNAVAILABLE
                        reason: not computed by Pix Lerian
                    p95MedOpeningTime:
                      value: '0.00'
                      coverage:
                        status: UNAVAILABLE
                        reason: not computed by Pix Lerian
                  dictLookups:
                    lookupCount: 48210
                    coverage:
                      status: PARTIAL
                      reason: >-
                        a key lookup the client makes before the initiate is not
                        seen; negative answers are not measured; Pix Agendado
                        key lookups are not measured
                  availability:
                    availabilityIndex: '0.00'
                    coverage:
                      status: UNAVAILABLE
                      reason: not computed by Pix Lerian
                  authorizationTimes:
                    p95AuthorizationTime:
                      value: '0.00'
                      coverage:
                        status: UNAVAILABLE
                        reason: not computed by Pix Lerian
                  authorizations:
                    rows:
                      - payerType: 1
                        authorizationCount: 0
                        activeAuthorizationCount: 0
                      - payerType: 2
                        authorizationCount: 0
                        activeAuthorizationCount: 0
                    coverage:
                      status: UNAVAILABLE
                      reason: not computed by Pix Lerian
              schema:
                $ref: '#/components/schemas/ApixReport'
          description: OK
        '400':
          content:
            application/problem+json:
              examples:
                PIX-0003:
                  value:
                    type: https://errors.lerian.studio/v1/PIX-0003
                    title: Bad Request
                    status: 400
                    detail: >-
                      Your request contains one or more fields with an invalid
                      data type.
                    code: PIX-0003
                PIX-0020:
                  value:
                    type: https://errors.lerian.studio/v1/PIX-0020
                    title: Bad Request
                    status: 400
                    detail: One or more query parameters are in an incorrect format.
                    errors:
                      - message: period does not match the 2006-01 format
                        location: period
                    code: PIX-0020
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            `period` absent or not YYYY-MM (PIX-0020), or a month before
            2020-11, when Pix started (PIX-0003).
        '401':
          description: >-
            Missing, malformed or expired bearer token, refused ahead of this
            operation by the authorization middleware in the legacy
            {code,title,message} envelope over application/json, with the
            generic client-error code PIX-0010. In a multi-tenant deployment the
            tenant middleware refuses a token it cannot read, or one with no
            usable tenantId claim, in the same shape with a code outside the
            PIX-NNNN catalogue: MISSING_TOKEN, INVALID_TOKEN, MISSING_TENANT or
            INVALID_TENANT. Branch on the status, not the body code.
        '403':
          description: >-
            The token lacks the permission this operation's resource and action
            require, refused ahead of it by the authorization middleware in the
            legacy {code,title,message} envelope over application/json, with the
            generic client-error code PIX-0010. The tenant middlewares also
            answer 403 with a code outside the PIX-NNNN catalogue:
            TENANT_SUSPENDED or TENANT_ACCESS_DENIED in a multi-tenant
            deployment, in the same shape, and TENANT_CONFIG_NOT_FOUND, in a
            {code,message} body, when the tenant's configuration cannot be
            resolved. Branch on the status, not the body code.
        '404':
          content:
            application/json:
              example:
                code: TENANT_NOT_FOUND
                title: Tenant Not Found
                message: 'tenant not found: 019606a1-3b4c-7d8e-9f01-234567890abc'
              schema:
                $ref: '#/components/schemas/LegacyErrorEnvelope'
            application/problem+json:
              examples:
                PIX-0711:
                  value:
                    type: https://errors.lerian.studio/v1/PIX-0711
                    title: Not Found
                    status: 404
                    detail: The month has no closed report. Close it first.
                    code: PIX-0711
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            The month has no current report: it was never closed, or it was
            reopened and not closed again (PIX-0711). Close it, then read it.
            The middleware ahead of this operation answers this status too (see
            default), in the legacy {code,title,message} envelope over
            application/json, NOT problem+json.
        '422':
          content:
            application/problem+json:
              examples:
                PIX-0710:
                  value:
                    type: https://errors.lerian.studio/v1/PIX-0710
                    title: Unprocessable Entity
                    status: 422
                    detail: The reference month has not started.
                    code: PIX-0710
              schema:
                $ref: '#/components/schemas/Detail'
          description: The reference month is in the future (PIX-0710).
        '500':
          content:
            application/json:
              example:
                code: PIX-0000
                title: Internal Server Error
                message: >-
                  The server encountered an unexpected error. Please try again
                  later.
              schema:
                $ref: '#/components/schemas/LegacyErrorEnvelope'
            application/problem+json:
              examples:
                PIX-0000:
                  value:
                    type: https://errors.lerian.studio/v1/PIX-0000
                    title: Internal Server Error
                    status: 500
                    detail: >-
                      The server encountered an unexpected error. Please try
                      again later.
                    code: PIX-0000
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            Unexpected server error (PIX-0000). The middleware ahead of this
            operation answers this status too (see default), in the legacy
            {code,title,message} envelope over application/json, NOT
            problem+json.
        '503':
          content:
            application/json:
              example:
                code: PIX-0000
                title: Internal Server Error
                message: >-
                  The server encountered an unexpected error. Please try again
                  later.
              schema:
                $ref: '#/components/schemas/LegacyErrorEnvelope'
            application/problem+json:
              examples:
                PIX-0062:
                  value:
                    type: https://errors.lerian.studio/v1/PIX-0062
                    title: Service Unavailable
                    status: 503
                    detail: >-
                      A dependency of this service is temporarily unavailable.
                      Retry as the route's guidance for an unknown outcome says.
                    code: PIX-0062
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            The month or its report could not be read: the read replica, or the
            primary it falls back to, is unreachable (PIX-0062). Nothing
            changed; send the request again. The middleware ahead of this
            operation answers this status too (see default), in the legacy
            {code,title,message} envelope over application/json, NOT
            problem+json.
        default:
          content:
            application/json:
              example:
                code: PIX-0000
                title: Internal Server Error
                message: >-
                  The server encountered an unexpected error. Please try again
                  later.
              schema:
                $ref: '#/components/schemas/LegacyErrorEnvelope'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: >-
            Error. Middleware ahead of this operation also refuses in the legacy
            {code,title,message} envelope over application/json: a body over the
            server's 4 MiB limit with 413 PIX-0010; a query value holding the
            NUL character (%00) or invalid UTF-8 with 400 PIX-0020; the Access
            Manager unavailable (503) or timing out (504) with PIX-0000; and, in
            a multi-tenant deployment, the tenant middleware with 404
            TENANT_NOT_FOUND, 500 TENANT_DB_ERROR, 503
            TENANT_MANAGER_UNAVAILABLE or SERVICE_UNAVAILABLE, and 504
            TENANT_MANAGER_TIMEOUT. Branch on the status; these middleware 503
            and 504 refusals are retryable. Any operation that uses the database
            also answers 503 PIX-0062 when its Postgres connection is lost; that
            request may or may not have been processed, so repeat it only as
            this operation's own guidance for an unknown outcome allows.
components:
  schemas:
    ApixReport:
      additionalProperties: false
      properties:
        blocks:
          $ref: '#/components/schemas/ApixBlocks'
          description: The ten APIX001 blocks in layout order, each with explicit coverage.
        ispb:
          description: ISPB of the participant the report is for.
          examples:
            - '12345678'
          type: string
        layoutVersion:
          description: APIX001 layout version the blocks follow.
          examples:
            - '2.7'
          type: string
        period:
          description: Reference month, YYYY-MM.
          examples:
            - 2026-10
          type: string
        reportId:
          description: >-
            Immutable identifier of this report; a reopen and a new close
            produce another.
          examples:
            - 0193a6f0-7c1e-7b4a-9d2e-5f6a7b8c9d0e
          type: string
      required:
        - reportId
        - period
        - ispb
        - layoutVersion
        - blocks
      type: object
    Detail:
      additionalProperties: true
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          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
    LegacyErrorEnvelope:
      additionalProperties: false
      properties:
        code:
          description: PIX-XXXX error code
          type: string
        message:
          description: Human-readable error message
          type: string
        title:
          description: Short error title
          type: string
        fields:
          additionalProperties:
            type: string
          description: Per-field detail, keyed by the field or header the refusal names
          type: object
        headers:
          additionalProperties:
            type: string
          description: Per-header detail, keyed by the request header the refusal names
          type: object
      required:
        - code
        - title
        - message
      type: object
    ApixBlocks:
      additionalProperties: false
      properties:
        authorizationTimes:
          $ref: '#/components/schemas/ApixAuthorizationTimesBlock'
        authorizations:
          $ref: '#/components/schemas/ApixAuthorizationsBlock'
        availability:
          $ref: '#/components/schemas/ApixAvailabilityBlock'
        cautionaryBlocks:
          $ref: '#/components/schemas/ApixCautionaryBlocksBlock'
        dictLookups:
          $ref: '#/components/schemas/ApixDICTLookupsBlock'
        dictTimes:
          $ref: '#/components/schemas/ApixDICTTimesBlock'
        refunds:
          $ref: '#/components/schemas/ApixRefundsBlock'
        revenues:
          $ref: '#/components/schemas/ApixRevenuesBlock'
        transactionTimes:
          $ref: '#/components/schemas/ApixTransactionTimesBlock'
        transactions:
          $ref: '#/components/schemas/ApixTransactionsBlock'
      required:
        - transactions
        - refunds
        - cautionaryBlocks
        - revenues
        - transactionTimes
        - dictTimes
        - dictLookups
        - availability
        - authorizationTimes
        - authorizations
      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
    ApixAuthorizationTimesBlock:
      additionalProperties: false
      properties:
        p95AuthorizationTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
      required:
        - p95AuthorizationTime
      type: object
    ApixAuthorizationsBlock:
      additionalProperties: false
      properties:
        coverage:
          $ref: '#/components/schemas/ApixCoverage'
          description: Whether the rows are data or fillers.
        rows:
          description: >-
            APIX001 layout Autorizacao: one row per payerType, zero rows
            included.
          items:
            $ref: '#/components/schemas/ApixAuthorizationRow'
          type:
            - array
            - 'null'
      required:
        - rows
        - coverage
      type: object
    ApixAvailabilityBlock:
      additionalProperties: false
      properties:
        availabilityIndex:
          description: >-
            APIX001 layout IndiceDisponibilidade, a percentage with two decimal
            places.
          examples:
            - '99.98'
          type: string
        coverage:
          $ref: '#/components/schemas/ApixCoverage'
          description: Whether availabilityIndex is data or a filler.
      required:
        - availabilityIndex
        - coverage
      type: object
    ApixCautionaryBlocksBlock:
      additionalProperties: false
      properties:
        coverage:
          $ref: '#/components/schemas/ApixCoverage'
          description: Whether the rows are data or fillers.
        rows:
          description: >-
            APIX001 layout cautionary blocks: one row per cautionaryBlockDetail,
            zero rows included.
          items:
            $ref: '#/components/schemas/ApixCautionaryBlockRow'
          type:
            - array
            - 'null'
      required:
        - rows
        - coverage
      type: object
    ApixDICTLookupsBlock:
      additionalProperties: false
      properties:
        coverage:
          $ref: '#/components/schemas/ApixCoverage'
          description: >-
            Whether lookupCount is data or a filler. PARTIAL whenever a lookup
            was measured, because a key lookup the client makes before the
            initiate is not seen; the reason also says negative answers are not
            measured and the Pix Agendado key lookups are not measured, plus the
            count of lookups without measurement. A month with lookups and none
            measured is UNAVAILABLE; a month with no lookup is 0 PARTIAL, never
            COMPLETE while the Pix Agendado lookups are not measured.
        lookupCount:
          description: >-
            APIX001 layout QtdConsultas. DICT key lookups Pix Lerian makes to
            start a Pix by key or by QR code in the month (America/Sao_Paulo)
            answered by the participant's own DICT copy: origins CACHE and
            LOCAL_COPY count, DICT does not. The population is the key and QR
            code initiations, whether or not the payment settled; a negative
            answer and a technical failure are not recorded and do not count.
          examples:
            - 48210
          format: int64
          type: integer
      required:
        - lookupCount
        - coverage
      type: object
    ApixDICTTimesBlock:
      additionalProperties: false
      properties:
        p95KeyDeletionUserExperienceTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p95KeyRegistrationCodeSendTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p95KeyRegistrationUserExperienceTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p95MedOpeningTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p95PortabilityNotificationTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p95PortabilitySendTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p99KeyLookupTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
          description: >-
            APIX001 layout Perc99TempoUsuarioConsulta. P99 of the DICT key
            lookups Pix Lerian makes to start a Pix by key or by QR code in the
            month (America/Sao_Paulo), whatever answered them (CACHE, LOCAL_COPY
            or DICT), in seconds rounded up to 2 places (nearest rank). The
            population is the key and QR code initiations. A lookup with a
            negative answer (key not found, refused by DICT) and a lookup that
            failed technically (timeout, connection, 5xx) start no initiation
            and are left out. The duration runs from the lookup request to the
            DICT hub to the decoded answer, retries included, so the value is a
            LOWER BOUND of the layout indicator: the participant's channel steps
            and the rest of the initiate are not in it. Whether to report it is
            the client's decision. Coverage is PARTIAL whenever a lookup was
            measured; the reason names the lower bound, a key lookup the client
            makes before the initiate, technical failures, negative answers and
            the Pix Agendado key lookups, which Pix Lerian does not measure,
            plus the count of lookups without measurement. A month with lookups
            and none measured is UNAVAILABLE; a month with no lookup is 0.00
            PARTIAL, never COMPLETE.
      required:
        - p99KeyLookupTime
        - p95KeyRegistrationCodeSendTime
        - p95KeyRegistrationUserExperienceTime
        - p95KeyDeletionUserExperienceTime
        - p95PortabilityNotificationTime
        - p95PortabilitySendTime
        - p95MedOpeningTime
      type: object
    ApixRefundsBlock:
      additionalProperties: false
      properties:
        coverage:
          $ref: '#/components/schemas/ApixCoverage'
          description: >-
            Whether the rows are data or fillers: UNAVAILABLE, never COMPLETE,
            when no refund outside SPI was informed for the month.
        rows:
          description: >-
            APIX001 layout Devolucao: one row per refundDetail, zero rows
            included. Only the OUTSIDE_SPI_REFUND facts current at the cutoff
            count, in the month of their settledAt; refunds settled in the SPI
            never do.
          items:
            $ref: '#/components/schemas/ApixRefundRow'
          type:
            - array
            - 'null'
      required:
        - rows
        - coverage
      type: object
    ApixRevenuesBlock:
      additionalProperties: false
      properties:
        coverage:
          $ref: '#/components/schemas/ApixCoverage'
          description: Whether the rows are data or fillers.
        rows:
          description: >-
            APIX001 layout Receita: one row per revenueSource, zero rows
            included.
          items:
            $ref: '#/components/schemas/ApixRevenueRow'
          type:
            - array
            - 'null'
      required:
        - rows
        - coverage
      type: object
    ApixTransactionTimesBlock:
      additionalProperties: false
      properties:
        maxCautionaryBlockTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p50OutsideSpiUserExperienceTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p50SpiUserExperienceTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p99OutsideSpiUserExperienceTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
        p99SpiUserExperienceTime:
          $ref: '#/components/schemas/ApixTimeIndicator'
      required:
        - p50SpiUserExperienceTime
        - p99SpiUserExperienceTime
        - p50OutsideSpiUserExperienceTime
        - p99OutsideSpiUserExperienceTime
        - maxCautionaryBlockTime
      type: object
    ApixTransactionsBlock:
      additionalProperties: false
      properties:
        detailCoverage:
          description: Coverage per transactionDetail; the block has none of its own.
          items:
            $ref: '#/components/schemas/ApixDetailCoverage'
          type:
            - array
            - 'null'
        rows:
          description: >-
            APIX001 layout Transacao: one row per transactionDetail and
            transactionPurpose, zero rows included.
          items:
            $ref: '#/components/schemas/ApixTransactionRow'
          type:
            - array
            - 'null'
      required:
        - rows
        - detailCoverage
      type: object
    ApixTimeIndicator:
      additionalProperties: false
      properties:
        coverage:
          $ref: '#/components/schemas/ApixCoverage'
          description: Whether value is data or a filler.
        value:
          description: >-
            Time with two decimal places, in seconds (in hours for
            maxCautionaryBlockTime); 0.00 when coverage is UNAVAILABLE. At most
            999999.99, the APIX001 layout tipoValorTempo ceiling: a longer time
            is reported as 999999.99 and the coverage is PARTIAL with the count
            of journeys above it.
          examples:
            - '2.84'
          type: string
      required:
        - value
        - coverage
      type: object
    ApixCoverage:
      additionalProperties: false
      properties:
        reason:
          description: Why the value is not COMPLETE. Absent when status is COMPLETE.
          examples:
            - not computed by Pix Lerian
          type: string
        status:
          description: >-
            COMPLETE: the value is data; PARTIAL: data with a known gap;
            UNAVAILABLE: the value is a filler, never a measured zero;
            NOT_APPLICABLE: the value does not apply to the tenant in the month
            and is a zero filler, as transactionDetail 5 with no
            settled-participant declaration in force in the month.
          enum:
            - COMPLETE
            - PARTIAL
            - UNAVAILABLE
            - NOT_APPLICABLE
          examples:
            - COMPLETE
          type: string
      required:
        - status
      type: object
    ApixAuthorizationRow:
      additionalProperties: false
      properties:
        activeAuthorizationCount:
          description: APIX001 layout QtdEstoqueAutorizacoes.
          examples:
            - 412
          format: int64
          type: integer
        authorizationCount:
          description: APIX001 layout QtdAutorizacoes.
          examples:
            - 57
          format: int64
          type: integer
        payerType:
          description: APIX001 layout TipoPagador.
          enum:
            - 1
            - 2
          examples:
            - 1
          format: int64
          type: integer
      required:
        - payerType
        - authorizationCount
        - activeAuthorizationCount
      type: object
    ApixCautionaryBlockRow:
      additionalProperties: false
      properties:
        cautionaryBlockAmount:
          description: APIX001 layout ValorBloqCaut, two decimal places.
          examples:
            - '1250.00'
          type: string
        cautionaryBlockCount:
          description: APIX001 layout QtdeBloqCaut.
          examples:
            - 3
          format: int64
          type: integer
        cautionaryBlockDetail:
          description: APIX001 layout DetalhamentoTransacoesBloqCaut.
          enum:
            - 1
            - 2
            - 3
            - 4
          examples:
            - 1
          format: int64
          type: integer
      required:
        - cautionaryBlockDetail
        - cautionaryBlockCount
        - cautionaryBlockAmount
      type: object
    ApixRefundRow:
      additionalProperties: false
      properties:
        refundAmount:
          description: >-
            APIX001 layout ValorDevolucoes, two decimal places. At most
            9999999999999.99, the layout ceiling: a larger sum is reported as
            9999999999999.99 and the coverage is PARTIAL with the count of rows
            above it.
          examples:
            - '310.00'
          type: string
        refundCount:
          description: APIX001 layout QtdDevolucoes.
          examples:
            - 12
          format: int64
          type: integer
        refundDetail:
          description: >-
            APIX001 layout DetalhamentoDevolucoes: 1 fraud (reasonCode FR01), 2
            other (MD06, SL02, BE08).
          enum:
            - 1
            - 2
          examples:
            - 1
          format: int64
          type: integer
      required:
        - refundDetail
        - refundCount
        - refundAmount
      type: object
    ApixRevenueRow:
      additionalProperties: false
      properties:
        revenueAmount:
          description: APIX001 layout ValorReceita, two decimal places.
          examples:
            - '980.40'
          type: string
        revenueSource:
          description: APIX001 layout FonteReceita.
          enum:
            - 1
            - 2
            - 3
            - 4
          examples:
            - 1
          format: int64
          type: integer
      required:
        - revenueSource
        - revenueAmount
      type: object
    ApixDetailCoverage:
      additionalProperties: false
      properties:
        coverage:
          $ref: '#/components/schemas/ApixCoverage'
          description: Coverage of every row with this transactionDetail.
        transactionDetail:
          description: APIX001 layout DetalhamentoTransacoes the coverage applies to.
          enum:
            - 5
            - 6
            - 7
          examples:
            - 5
          format: int64
          type: integer
      required:
        - transactionDetail
        - coverage
      type: object
    ApixTransactionRow:
      additionalProperties: false
      properties:
        cashAmount:
          description: >-
            APIX001 layout ValorEspecie, two decimal places. At most
            9999999999999.99, the layout ceiling: a larger sum is reported as
            9999999999999.99 and the coverage is PARTIAL with the count of rows
            above it.
          examples:
            - '0.00'
          type: string
        transactionAmount:
          description: >-
            APIX001 layout ValorTransacoes, two decimal places. At most
            9999999999999.99, the layout ceiling: a larger sum is reported as
            9999999999999.99 and the coverage is PARTIAL with the count of rows
            above it.
          examples:
            - '38450.75'
          type: string
        transactionCount:
          description: APIX001 layout QtdTransacoes.
          examples:
            - 1520
          format: int64
          type: integer
        transactionDetail:
          description: APIX001 layout DetalhamentoTransacoes.
          enum:
            - 5
            - 6
            - 7
          examples:
            - 5
          format: int64
          type: integer
        transactionPurpose:
          description: APIX001 layout FinalidadeTransacoes.
          enum:
            - 1
            - 2
            - 3
            - 4
          examples:
            - 1
          format: int64
          type: integer
      required:
        - transactionDetail
        - transactionPurpose
        - transactionCount
        - transactionAmount
        - cashAmount
      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.