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

# Get submission report

> Reported-versus-pending counts of accounts and messages.

<Note>
  `accounts` counts the accounts you pushed, each of which is one account report. `messages` counts the messages sent to the tax authority: total generated, accepted, and still awaiting a response. The accounts with outstanding errors are listed by [List account errors](/regulatory/rrc/api/fatca/get-account-errors).
</Note>


## OpenAPI

````yaml get /reports/fatca/v1/submissions/{submissionId}/report
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}/report:
    get:
      tags:
        - FATCA REST API
      summary: Get submission report
      description: >-
        Detailed reporting status of the submission: overall status, how many
        accounts are reported versus still pending, the number of messages sent
        to the tax authority, and each account's state.
      operationId: getSubmissionReport
      parameters:
        - name: submissionId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FatcaSubmissionReport'
              examples:
                example:
                  $ref: '#/components/examples/FatcaGetReport200'
components:
  schemas:
    FatcaSubmissionReport:
      type: object
      description: >-
        Detailed reporting status: overall status, reported and pending account
        counts, and the number of messages sent to the tax authority. Accounts
        with outstanding errors are listed, page by page, by the account errors
        endpoint.
      properties:
        submissionId:
          type: string
        reportingYear:
          type: integer
          format: int32
        kind:
          $ref: '#/components/schemas/FatcaSubmissionKind'
        status:
          $ref: '#/components/schemas/FatcaSubmissionStatus'
        accounts:
          $ref: '#/components/schemas/FatcaProgressCount'
          description: Accounts you pushed, each of which is one account report
        messages:
          $ref: '#/components/schemas/FatcaProgressCount'
          description: >-
            Messages sent to the tax authority: total generated, accepted, and
            still awaiting a response
      required:
        - accounts
        - kind
        - messages
        - reportingYear
        - status
        - submissionId
    FatcaSubmissionKind:
      type: string
      description: >-
        SUBMISSION reports accounts for a year not yet reported; CORRECTION
        amends what was already reported for it.
      enum:
        - SUBMISSION
        - CORRECTION
    FatcaSubmissionStatus:
      type: string
      description: High-level lifecycle status of a submission
      enum:
        - DRAFT
        - PROCESSING
        - ACTION_REQUIRED
        - REPORTED
        - FAILED
    FatcaProgressCount:
      type: object
      description: Totals split into already-reported and still-pending
      properties:
        total:
          type: integer
          format: int64
        reported:
          type: integer
          format: int64
        pending:
          type: integer
          format: int64
      required:
        - pending
        - reported
        - total
  examples:
    FatcaGetReport200:
      value:
        submissionId: 3f2a9c1e-7b4d-4e8a-9f61-2c5d8e0b1a47
        reportingYear: 2025
        kind: SUBMISSION
        status: REPORTED
        accounts:
          total: 2
          reported: 2
          pending: 0
        messages:
          total: 1
          reported: 1
          pending: 0
  securitySchemes:
    bearer-jwt:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: >-
            https://auth.sandbox.finventi.com/realms/sti-connector/protocol/openid-connect/token
          scopes: {}

````