> ## 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. # Everything the provider refused about one submission > Returns every issue the pension provider reported for one part of a pay run, each with the record it relates to, the provider's own code, and the provider's own wording. A submission's record carries the first page of these and the total; use this when the total is larger than the page, or whenever the complete list is wanted. Returns an empty list for a submission the provider accepted. ## OpenAPI ````yaml /api-reference/specs/pension-v2.json get /provider-sync/{payrollConfigId}/{year}/{frequency}/{period}/issues 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: /provider-sync/{payrollConfigId}/{year}/{frequency}/{period}/issues: get: tags: - Provider submissions summary: Everything the provider refused about one submission description: >- Returns every issue the pension provider reported for one part of a pay run, each with the record it relates to, the provider's own code, and the provider's own wording. A submission's record carries the first page of these and the total; use this when the total is larger than the page, or whenever the complete list is wanted. Returns an empty list for a submission the provider accepted. operationId: GetPayRunSubmissionIssues parameters: - name: payrollConfigId in: path required: true schema: type: string - name: year in: path required: true schema: type: integer format: int32 - name: frequency in: path required: true schema: type: string - name: period in: path required: true schema: type: integer format: int32 - name: schemeId in: query required: true schema: type: string - name: operationType in: query required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ProviderSyncIssueV2ListResponseBody' '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: ProviderSyncIssueV2ListResponseBody: required: - message type: object properties: message: $ref: '#/components/schemas/MessageWithTokenResponse' content: $ref: '#/components/schemas/ProviderSyncIssueV2ListContentResponse' 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`. ProviderSyncIssueV2ListContentResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ProviderSyncIssueV2' nullable: true 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 ProviderSyncIssueV2: required: - message type: object properties: reference: type: string description: |- The identifier the submission sent for the record concerned, so it can be matched back to a person. Absent when the provider refused the submission as a whole rather than one of its records. nullable: true referenceLabel: type: string description: |- Who that reference is, resolved from the pay run: show this rather than the raw reference. Absent when the reference matches nobody in the run, or when the provider refused the submission as a whole. nullable: true employeeId: type: string description: >- The employee this refusal is about, as their own id. The reference is whatever identifier the scheme sends the provider (a payroll id, say), which is not something a caller can look an employee up by, so the link to the person is carried rather than inferred from it. nullable: true code: type: string description: The provider's own error code, for support and audit. nullable: true message: type: string description: The provider's own wording. Safe to show a user as-is. nullable: true noActionNeeded: type: boolean description: >- True when the provider is confirming this record already holds what the submission asked for, rather than refusing it: a worker an earlier send already enrolled, which is what a re-sent batch looks like from the provider's side. Show these, so what is on screen matches the provider's own answer, but apart from the ones somebody has to act on and never as a reason the submission failed. A record with `Status``Succeeded` can still carry them. additionalProperties: false description: One thing the pension provider refused. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.