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

> List the submissions and corrections you have opened.



## OpenAPI

````yaml get /reports/cesop/v1/submissions
openapi: 3.1.0
info:
  title: CESOP REST API
  description: >
    <p>REST API for reporting CESOP(The Central Electronic System of Payment
    information). Create a submission, send payees

    and payments under its id, then submit it to the regulatory authority.</p>


    <p><strong>Filtering is the reporting company's responsibility.</strong>
    This API reports the data you send as-is, and it does not decide which
    payments are reportable. Apply the CESOP filtering rules before sending.</p>


    <p><strong>European Commission's official reporting guideline:</strong>

    <a href="docs/cesop-guidelines-v1.2.pdf">CESOP Guidelines for the reporting
    of payment data v1.2 (PDF)</a></p>


    <p><strong>CESOP filtering rules, PSP's implementation guide:</strong>

    <a href="docs/cesop-filtering-rules.html">open the guide</a>. This is a
    quick reference only, it may not cover every case. For accurate handling of
    specific cases, refer to the regulation and official CESOP
    documentation.</p>


    <p><strong>Regulation:</strong>

    <a href="https://eur-lex.europa.eu/eli/dir/2020/284/oj">Council Directive
    (EU) 2020/284</a>

    &middot;

    <a
    href="https://taxation-customs.ec.europa.eu/taxation-1/central-electronic-system-payment-information-cesop_en">CESOP
    — European Commission</a></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: CESOP Filtering Support
    description: >-
      Helper endpoints supporting CESOP filtering decisions. This is not part of
      the submission flow.Use them to prepare your data before sending it via
      the CESOP Submission API.
  - name: CESOP REST API
    description: >-
      REST API for submitting and correcting CESOP payee and payment data.
      Create a submission, push payees and payments under its id, then submit it
      to the regulatory authority.
paths:
  /reports/cesop/v1/submissions:
    get:
      tags:
        - CESOP REST API
      summary: List submissions
      description: >-
        Lists the submissions and corrections you have opened, optionally
        filtered by year, quarter and reportable country. Any filter left out is
        ignored; with no filters it returns all of them.
      operationId: listSubmissions
      parameters:
        - name: year
          in: query
          required: false
          schema:
            type: integer
            format: int32
            maximum: 2100
            minimum: 2024
        - name: quarter
          in: query
          required: false
          schema:
            type: integer
            format: int32
            maximum: 4
            minimum: 1
        - name: country
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SubmissionSummary'
components:
  schemas:
    SubmissionSummary:
      type: object
      description: >-
        A submission or correction the client opened, with its period and
        current status
      properties:
        submissionId:
          type: string
          description: Submission id
        year:
          type: integer
          format: int32
        quarter:
          type: integer
          format: int32
        countryCode:
          type: string
          description: Reportable country (ISO 3166-1 alpha-2)
        status:
          type: string
          description: High-level lifecycle status of a submission
          enum:
            - DRAFT
            - PROCESSING
            - ACTION_REQUIRED
            - REPORTED
            - FAILED
      required:
        - countryCode
        - quarter
        - status
        - submissionId
        - year
  securitySchemes:
    bearer-jwt:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: >-
            https://auth.sandbox.finventi.com/realms/sti-connector/protocol/openid-connect/token
          scopes: {}

````