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

# Get all EPS submissions by tax year

> Retrieves all EPS submissions for the current organisation for a specific tax year with pagination support



## OpenAPI

````yaml /api-reference/specs/pay-api.yaml get /rti/eps/{taxYear}/submissions
openapi: 3.0.3
info:
  title: FlowPayroll API
  description: >-
    API for payroll management, including payroll upload, lock, HMRC submission,
    employee management
  version: 0.1.0
servers:
  - url: https://api.sandbox.flowpayroll.ai/v1
security:
  - XAuthToken: []
    XOrgId: []
tags:
  - name: Employees
    description: >-
      Create, retrieve, update, and delete employee records, and look them up by
      NI number or payroll ID.
  - name: Starters & leavers
    description: Set and clear starter and leaver details, individually or in bulk.
  - name: Tax codes
    description: >-
      Manage employee tax codes and query the effective tax code and NI category
      on a given date.
  - name: NI & identifiers
    description: Manage NI categories, National Insurance numbers, and payroll IDs.
  - name: Student loans
    description: Start and end student and postgraduate loans.
  - name: Payroll setup
    description: Assign an employee's payroll config and set opening balances.
  - name: Payroll
  - name: Payroll lines
  - name: PayrollConfig
  - name: Pay Elements
  - name: Calculator
  - name: Payslip
  - name: RTI
  - name: YearEnd
  - name: Organisation
paths:
  /rti/eps/{taxYear}/submissions:
    get:
      tags:
        - RTI
      summary: Get all EPS submissions by tax year
      description: >-
        Retrieves all EPS submissions for the current organisation for a
        specific tax year with pagination support
      operationId: getAllEpsSubmissionsByTaxYear
      parameters:
        - name: taxYear
          in: path
          required: true
          schema:
            type: integer
            minimum: 1800
            maximum: 3000
          description: The tax year to retrieve EPS submissions for
        - name: pageSize
          in: query
          required: false
          schema:
            type: string
            pattern: ^[0-9]+$
          description: 'Number of items per page (default: 20, max: 100)'
        - name: paginationToken
          in: query
          required: false
          schema:
            type: string
          description: Token for pagination to get the next page of results
      responses:
        '200':
          description: Successfully retrieved EPS submissions
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ResponseBody'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/EpsSubmissionEntryDto'
                        description: List of EPS submissions
                      metadata:
                        type: object
                        properties:
                          paginationToken:
                            type: string
                            description: Token for the next page of results
                            nullable: true
        '400':
          description: Invalid tax year or pagination parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseBody'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseBody'
components:
  schemas:
    ResponseBody:
      type: object
      properties:
        message:
          $ref: '#/components/schemas/MessageWithTokenResponse'
        content:
          type: object
          properties:
            data:
              type: object
              nullable: true
            metadata:
              type: object
              nullable: true
              properties:
                dateFormat:
                  type: string
                  default: yyyy-MM-dd
                dateTimeFormat:
                  type: string
                  default: yyyy-MM-ddTHH:mm:ss.fffZ
                paginationToken:
                  type: string
                  nullable: true
        validationIssues:
          type: array
          items:
            $ref: '#/components/schemas/ValidationIssue'
        messageToken:
          type: string
    EpsSubmissionEntryDto:
      type: object
      properties:
        submissionId:
          type: string
          description: The unique submission ID
          example: EPS_2025_001
        taxYear:
          type: integer
          description: The tax year
          example: 2025
        taxMonth:
          type: integer
          description: The tax month (1-12)
          nullable: true
          minimum: 1
          maximum: 12
          example: 6
        organisationId:
          type: string
          description: The organisation ID
          example: org_123
        hmrcEpsReportStatus:
          type: string
          description: The HMRC EPS report status
          enum:
            - NotSent
            - Sending
            - Sent
            - Failed
          example: Sent
        createdDate:
          type: string
          format: date-time
          description: Creation date
          example: '2025-01-01T00:00:00Z'
        createdBy:
          type: string
          description: User who created the record
          example: user_123
        updatedDate:
          type: string
          format: date-time
          description: Last update date
          example: '2025-01-02T00:00:00Z'
        updatedBy:
          type: string
          description: User who last updated the record
          example: user_456
        submissionBody:
          type: string
          description: The submission body
          nullable: true
          example: Submission body content
        correlationID:
          type: string
          description: The correlation ID
          nullable: true
          example: corr_123
        submissionDate:
          type: string
          format: date-time
          description: The submission date
          nullable: true
          example: '2025-01-01T00:00:00Z'
        submissionResponse:
          type: string
          description: The submission response
          nullable: true
          example: Response from HMRC
        errors:
          type: array
          items:
            type: string
          description: List of errors
          nullable: true
          example:
            - Error message 1
            - Error message 2
      required:
        - submissionId
        - taxYear
        - organisationId
        - hmrcEpsReportStatus
        - createdDate
        - createdBy
        - updatedDate
        - updatedBy
    MessageWithTokenResponse:
      type: object
      properties:
        text:
          type: string
        token:
          type: string
        tokenArguments:
          type: array
          items:
            $ref: '#/components/schemas/ValidationIssueArgument'
    ValidationIssue:
      type: object
      description: >
        Field validation item. `reasonToken` is a stable snake_case key for i18n
        or custom client messages; `reason` is the default English text from the
        API.
      properties:
        field:
          type: string
          description: Dot-path of the field (e.g. name.firstName, address.line1).
        reason:
          type: string
          description: Default human-readable message.
        reasonToken:
          type: string
          description: Machine-readable error identifier (snake_case).
        reasonTokenArguments:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/ValidationIssueArgument'
    ValidationIssueArgument:
      type: object
      properties:
        name:
          type: string
        value:
          type: string
  securitySchemes:
    XAuthToken:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: Access token obtained from OAuth2 client credentials flow
    XOrgId:
      type: apiKey
      in: header
      name: X-Org-Id
      description: >-
        Organisation to scope the request to. Required when the principal can
        access more than one organisation; optional for single-organisation
        principals (the authorizer resolves it automatically).

````