> ## 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. # List an employee's contribution overrides > Returns the employee's contribution overrides in pay-period order, one page at a time. The response carries the items plus a paginationToken when there is another page. ## OpenAPI ````yaml /api-reference/specs/pension-v2.json get /employee-pension/{employeeId}/contribution-overrides openapi: 3.0.4 info: title: FlowPayroll Pension API version: v2 servers: - url: https://api.sandbox.flowpayroll.ai/v2/pension security: [] tags: - name: Pension providers description: >- Look up the pension providers available to your organisation. Providers are set up in the product, so the API exposes them read-only. - name: Pension schemes description: >- Your organisation's arrangements with providers. Scheme endpoints use the /pension-schema path. - name: Pension groups description: >- Contribution rule sets within a scheme: pension type, contribution basis, and employee and employer factors. - name: Employee enrolment description: >- Associate employees with pension groups, remove associations, and send enrolment letters. - name: Pension information description: >- An employee's full pension picture in one call: composition, latest assessment, and postponement. - name: Auto-enrolment description: >- Assessment results per pay run, employees with outstanding or no auto-enrolment, and a stateless assessment preview. - name: Postponement description: Defer auto-enrolment per employee, overriding the organisation defaults. - name: Organisation defaults description: >- The organisation's default pension group, postponement definitions, and auto-enrolment mode. - name: Pension calculations description: >- Per-period contribution amounts, the contributions CSV, and provider export files. - name: Provider submissions description: >- Send a completed pay run to its connected pension provider, approve the payment, and read back what the provider reported: opt-outs, stopped contributions, refunds and schedules. paths: /employee-pension/{employeeId}/contribution-overrides: get: tags: - ContributionOverride summary: List an employee's contribution overrides description: >- Returns the employee's contribution overrides in pay-period order, one page at a time. The response carries the items plus a paginationToken when there is another page. operationId: ListContributionOverrides parameters: - name: employeeId in: path required: true schema: type: string - name: pageSize in: query description: >- The maximum number of contribution overrides to return (1-100, default 50). schema: type: integer description: >- The maximum number of contribution overrides to return (1-100, default 50). format: int32 - name: paginationToken in: query description: >- The pagination token from the previous page. Always follow the token until it is absent rather than treating a short page as the last one. schema: type: string description: >- The pagination token from the previous page. Always follow the token until it is absent rather than treating a short page as the last one. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ContributionOverrideListModelResponseBody' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' components: schemas: ContributionOverrideListModelResponseBody: required: - message type: object properties: message: $ref: '#/components/schemas/MessageWithTokenResponse' content: $ref: '#/components/schemas/ContributionOverrideListModelContentResponse' validationIssues: type: array items: $ref: '#/components/schemas/ValidationIssue' nullable: true errors: type: array items: $ref: '#/components/schemas/Error' description: >- Deprecated: the same issues as `validationIssues` (`reasonText` is `reason`, `reasonId` is `reasonToken`, `reasonParameters` is `reasonTokenArguments`). Read `validationIssues`; this will be removed. nullable: true readOnly: true deprecated: true metadata: allOf: - $ref: '#/components/schemas/ContentMetadataResponse' description: >- Deprecated: the same values as `content.metadata`. Read that; this will be removed. deprecated: true additionalProperties: false description: >- The response envelope every FlowPayroll API answers with: a `message`, the `content`, and any `validationIssues`. `errors` and the top-level `metadata` are deprecated copies of `validationIssues` and `content.metadata`, and will be removed. ObjectResponseBody: required: - message type: object properties: message: $ref: '#/components/schemas/MessageWithTokenResponse' content: $ref: '#/components/schemas/ObjectContentResponse' validationIssues: type: array items: $ref: '#/components/schemas/ValidationIssue' nullable: true errors: type: array items: $ref: '#/components/schemas/Error' description: >- Deprecated: the same issues as `validationIssues` (`reasonText` is `reason`, `reasonId` is `reasonToken`, `reasonParameters` is `reasonTokenArguments`). Read `validationIssues`; this will be removed. nullable: true readOnly: true deprecated: true metadata: allOf: - $ref: '#/components/schemas/ContentMetadataResponse' description: >- Deprecated: the same values as `content.metadata`. Read that; this will be removed. deprecated: true additionalProperties: false description: >- The response envelope every FlowPayroll API answers with: a `message`, the `content`, and any `validationIssues`. `errors` and the top-level `metadata` are deprecated copies of `validationIssues` and `content.metadata`, and will be removed. MessageWithTokenResponse: required: - token type: object properties: text: type: string nullable: true token: type: string description: >- Stable snake_case key for the message, for clients that translate it. nullable: true tokenArguments: type: array items: $ref: '#/components/schemas/ValidationIssueArgument' nullable: true textId: type: string description: >- Deprecated: the same value as `token`. Read that; this will be removed. nullable: true readOnly: true deprecated: true textParameters: type: array items: $ref: '#/components/schemas/Pair' description: >- Deprecated: the same values as `tokenArguments`. Read that; this will be removed. nullable: true readOnly: true deprecated: true additionalProperties: false description: >- What happened, as English `text` and a stable `token` to translate from. `textId` and `textParameters` are deprecated copies of `token` and `tokenArguments`. ContributionOverrideListModelContentResponse: type: object properties: data: $ref: '#/components/schemas/ContributionOverrideListModel' metadata: $ref: '#/components/schemas/ContentMetadataResponse' additionalProperties: false ValidationIssue: type: object properties: field: type: string nullable: true reason: type: string nullable: true reasonToken: type: string nullable: true reasonTokenArguments: type: array items: $ref: '#/components/schemas/ValidationIssueArgument' nullable: true additionalProperties: false Error: type: object properties: field: type: string nullable: true reasonText: type: string nullable: true reasonId: type: string nullable: true reasonParameters: type: array items: $ref: '#/components/schemas/Pair' nullable: true additionalProperties: false description: >- Deprecated: an entry of the old `errors` list. Read `validationIssues` instead. deprecated: true ContentMetadataResponse: type: object properties: dateFormat: type: string nullable: true dateTimeFormat: type: string nullable: true paginationToken: type: string nullable: true additionalProperties: false ObjectContentResponse: type: object properties: data: nullable: true metadata: $ref: '#/components/schemas/ContentMetadataResponse' additionalProperties: false ValidationIssueArgument: type: object properties: name: type: string nullable: true value: nullable: true additionalProperties: false Pair: type: object properties: key: type: string nullable: true value: type: string nullable: true additionalProperties: false description: >- Deprecated: a key and value of the old `textParameters` and `reasonParameters`. deprecated: true ContributionOverrideListModel: required: - items type: object properties: items: type: array items: $ref: '#/components/schemas/ContributionOverrideModel' description: The overrides on this page, in pay-period order. nullable: true paginationToken: type: string description: >- Deprecated: the same value as `content.metadata.paginationToken`. Read that; this will be removed. nullable: true deprecated: true additionalProperties: false description: One page of an employee's contribution overrides. ContributionOverrideModel: required: - contributionOverride - createdBy - createdDate - employeeId - period - taxYear - updatedBy - updatedDate type: object properties: employeeId: type: string nullable: true taxYear: type: integer description: The tax year the pay period belongs to (e.g. 2026 for 2026/27). format: int32 period: type: integer description: The pay period number within the tax year. format: int32 contributionOverride: $ref: '#/components/schemas/ContributionOverrideValuesModel' createdBy: type: string nullable: true createdDate: type: string format: date-time updatedBy: type: string nullable: true updatedDate: type: string format: date-time additionalProperties: false description: >- A contribution override for one pay period only: for that period it replaces the group settings and any standing association override, then expires. Additional voluntary contributions stay additive on top of it. At most one per employee per pay period; a repeated PUT replaces it. ContributionOverrideValuesModel: required: - contributionType type: object properties: contributionType: enum: - Percentage - FixedAmount type: string nullable: true employeeFactor: type: number format: float nullable: true employerFactor: type: number format: float nullable: true employeeFixedAmount: type: number format: double nullable: true employerFixedAmount: type: number format: double nullable: true additionalProperties: false description: >- Per-employee contribution override. When present on an association it fully replaces the pension group's contribution settings. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.