> ## 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 account errors

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



## OpenAPI

````yaml get /reports/fatca/v1/submissions/{submissionId}/accounts/errors
openapi: 3.1.0
info:
  title: FATCA REST API
  description: >
    <p>REST API for reporting FATCA (Foreign Account Tax Compliance Act) US
    reportable account data. Open a submission for

    a reporting year, send the reportable accounts under its id, then submit it
    to the tax authority.</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: FATCA REST API
    description: >-
      REST API for submitting and correcting FATCA account data. Create a
      submission for a reporting year, push the reportable accounts under its
      id, the service will package the account data and send it to the
      regulatory authority.
paths:
  /reports/fatca/v1/submissions/{submissionId}/accounts/errors:
    get:
      tags:
        - FATCA REST API
      summary: List account errors
      description: >-
        Returns a page of accounts in this submission that currently have
        unresolved tax authority validation errors, together with the error
        codes and messages. An entry disappears from this list once the account
        is corrected and re-reported.
      operationId: getAccountErrors
      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/FatcaAccountResultPaged'
              examples:
                example:
                  $ref: '#/components/examples/FatcaGetAccountErrors200'
components:
  schemas:
    FatcaAccountResultPaged:
      type: object
      description: A page of account results
      properties:
        pageNumber:
          type: integer
          format: int32
        pageSize:
          type: integer
          format: int32
        totalElements:
          type: integer
          format: int64
        items:
          type: array
          items:
            $ref: '#/components/schemas/FatcaAccountResult'
      required:
        - items
        - pageNumber
        - pageSize
        - totalElements
    FatcaAccountResult:
      type: object
      description: Result of pushing, updating or deleting a single account
      properties:
        status:
          $ref: '#/components/schemas/Status'
        accountNumber:
          type: string
          description: >-
            The account number echoed back, to correlate this result with your
            record
        errors:
          type: array
          description: Why the account was rejected. Empty when the account was 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:
    FatcaGetAccountErrors200:
      value:
        pageNumber: 0
        pageSize: 1000
        totalElements: 1
        items:
          - status: FAILED
            accountNumber: LT601010012345678901
            errors:
              - code: '400051'
                fields:
                  - accountHolder.organisation.tins
                message: >-
                  At least one TIN of the organisation account holder must be
                  issued by the US.
  securitySchemes:
    bearer-jwt:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: >-
            https://auth.sandbox.finventi.com/realms/sti-connector/protocol/openid-connect/token
          scopes: {}

````