> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finventi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List person errors

> Persons rejected by the tax authority, with error codes.

<Note>
  Shared by all three sub-reports. An entry disappears from this list once the person is corrected and re-reported.
</Note>


## OpenAPI

````yaml get /reports/mai55/v1/submissions/{submissionId}/errors
openapi: 3.1.0
info:
  title: MAI55 REST API
  description: >
    <p>REST API for reporting MAI55 data to the Lithuanian State Tax
    Inspectorate. Open a submission for a

    reporting year, push the reportable persons under its id, then submit it to
    the tax authority.</p>


    <p>A submission carries exactly one sub-report, chosen with
    <code>type</code>: <strong>SIPL</strong> (account

    incomes), <strong>SLIK</strong> (account balances) or <strong>SKIS</strong>
    (outstanding debt

    agreements).</p>
  version: 0.0.1
servers:
  - url: https://api.rrc.dev.finventi.com
    description: Development
  - url: https://api.rrc.finventi.com
    description: Production
security:
  - bearer-jwt: []
tags:
  - name: Submissions
  - name: SLIK
  - name: SKIS
  - name: SIPL
paths:
  /reports/mai55/v1/submissions/{submissionId}/errors:
    get:
      tags:
        - Submissions
      summary: List person errors
      description: >-
        Returns a page of persons in this submission that currently have
        unresolved tax authority validation errors, with the error codes and
        messages. An entry disappears from this list once the person is
        corrected and re-reported. Shared by all three sub-reports: the
        reportable person is the unit of validation in each of them.
      operationId: getPersonErrors
      parameters:
        - name: submissionId
          in: path
          required: true
          schema:
            type: string
        - name: page
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 0
            minimum: 0
        - name: pageSize
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 1000
            maximum: 10000
            minimum: 1
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonResultPaged'
              examples:
                GetPersonErrors200:
                  $ref: '#/components/examples/GetPersonErrors200'
components:
  schemas:
    PersonResultPaged:
      type: object
      description: A page of person results
      properties:
        pageNumber:
          type: integer
          format: int32
        pageSize:
          type: integer
          format: int32
        totalElements:
          type: integer
          format: int64
        items:
          type: array
          items:
            $ref: '#/components/schemas/PersonResult'
      required:
        - items
        - pageNumber
        - pageSize
        - totalElements
    PersonResult:
      type: object
      description: Result of pushing, updating or deleting a single person
      properties:
        status:
          $ref: '#/components/schemas/Status'
        clientPersonId:
          type: string
          description: >-
            Your id for the person, echoed back to correlate this result with
            your record
          example: CLIENT-000123
        errors:
          type: array
          description: Why the person was rejected. Empty when accepted.
          items:
            $ref: '#/components/schemas/FieldError'
      required:
        - errors
        - status
    Status:
      type: string
      enum:
        - SUCCESS
        - FAILED
    FieldError:
      type: object
      description: Per-item validation/processing error
      properties:
        code:
          type: string
          description: >-
            Validation error code returned by the regulatory authority; only
            present for records that failed authority validation
          example: 51
        fields:
          type: array
          description: >-
            Fields that caused the error; may be empty for errors not tied to a
            single field (e.g. cross-field validation)
          example:
            - iban
          items:
            type: string
        message:
          type: string
          description: Human-readable error message
      required:
        - fields
  examples:
    GetPersonErrors200:
      value:
        pageNumber: 0
        pageSize: 1000
        totalElements: 1
        items:
          - status: FAILED
            clientPersonId: CLIENT-000124
            errors:
              - code: '51'
                fields: []
                message: Neteisingas asmens kodas
  securitySchemes:
    bearer-jwt:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: >-
            https://auth.sandbox.finventi.com/realms/sti-connector/protocol/openid-connect/token
          scopes: {}

````