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

# Get auto-enrolment assessments

> Returns the auto-enrolment eligibility assessment log for an employee, most recent first. An assessment record is written at each payroll approval for employees who go through the AE assessment path (i.e. not already ACTIVE or OPTED_OUT). Each record captures worker category, qualifying earnings, age, eligibility trigger, and whether auto-enrolment was performed. Already-enrolled or opted-out employees do not generate assessment records.



## OpenAPI

````yaml /api-reference/preview.json get /gb/organizations/{organization_id}/employees/{employee_id}/pension/assessments
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security: []
paths:
  /gb/organizations/{organization_id}/employees/{employee_id}/pension/assessments:
    get:
      tags:
        - Great Britain
        - Pension
      summary: Get auto-enrolment assessments
      description: >-
        Returns the auto-enrolment eligibility assessment log for an employee,
        most recent first. An assessment record is written at each payroll
        approval for employees who go through the AE assessment path (i.e. not
        already ACTIVE or OPTED_OUT). Each record captures worker category,
        qualifying earnings, age, eligibility trigger, and whether
        auto-enrolment was performed. Already-enrolled or opted-out employees do
        not generate assessment records.
      operationId: >-
        get_pension_assessments_gb_organizations__organization_id__employees__employee_id__pension_assessments_get
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            anyOf:
              - type: string
              - type: string
                format: uuid
            title: Organization Id
        - name: employee_id
          in: path
          required: true
          schema:
            anyOf:
              - type: string
              - type: string
                format: uuid
            title: Employee Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PensionAssessmentResponse'
                title: >-
                  Response Get Pension Assessments Gb Organizations 
                  Organization Id  Employees  Employee Id  Pension Assessments
                  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - BearerToken: []
components:
  schemas:
    PensionAssessmentResponse:
      properties:
        assessment_date:
          type: string
          format: date
          title: Assessment Date
          description: Date of the assessment; equals the pay_date from the pay calendar
        worker_category:
          $ref: '#/components/schemas/WorkerCategory'
          description: >-
            AE worker category determined by the system on this date based on
            age and earnings: ELIGIBLE_JOBHOLDER, NON_ELIGIBLE_JOBHOLDER,
            ENTITLED_WORKER, or EXCLUDED
        eligibility_trigger:
          $ref: '#/components/schemas/EligibilityTrigger'
          description: >-
            What initiated this assessment: NEW_HIRE (first payrun for this
            employee), EARNINGS_THRESHOLD (earnings crossed the trigger for the
            first time), AGE_THRESHOLD (employee turned 22), RE_ENROLMENT
            (3-year cyclical re-enrolment), PAY_PERIOD_ASSESSMENT (routine check
            on every payrun)
        enrolment_required:
          type: boolean
          title: Enrolment Required
          description: >-
            True if the employee was eligible and not yet enrolled —
            auto_enrol() was called and the employee was enrolled into the
            default scheme. False if already ACTIVE, not eligible, or on
            postponement
        re_enrolment_indicator:
          type: boolean
          title: Re Enrolment Indicator
          description: >-
            True if this was a cyclical re-enrolment (employee had previously
            opted out and is being re-enrolled under the 3-year duty); false for
            initial enrolment
        qualifying_earnings:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Qualifying Earnings
          description: >-
            Earnings within the AE qualifying band (£6,240–£50,270/year,
            pro-rated for the period) used as the contribution base; null if the
            employee was not eligible or contributions were not calculated
        age_at_assessment:
          anyOf:
            - type: integer
            - type: 'null'
          title: Age At Assessment
          description: >-
            Employee's age in whole years on the assessment date; null if date
            of birth was unavailable
        payrun_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Payrun Id
          description: >-
            ID of the payrun in which this assessment was performed; null for
            assessments triggered outside a payrun (e.g. manual enrolment)
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Timestamp when this assessment record was created
      additionalProperties: true
      type: object
      required:
        - assessment_date
        - worker_category
        - eligibility_trigger
        - enrolment_required
        - re_enrolment_indicator
        - qualifying_earnings
        - age_at_assessment
        - payrun_id
        - created_at
      title: PensionAssessmentResponse
      description: |-
        A single auto-enrolment eligibility assessment record.

        Created on every payroll approval for each employee in the payrun.
        The list is returned newest-first (descending assessment_date).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    WorkerCategory:
      type: string
      enum:
        - ELIGIBLE_JOBHOLDER
        - NON_ELIGIBLE_JOBHOLDER
        - ENTITLED_WORKER
        - EXCLUDED
      title: WorkerCategory
    EligibilityTrigger:
      type: string
      enum:
        - NEW_HIRE
        - EARNINGS_THRESHOLD
        - AGE_THRESHOLD
        - RE_ENROLMENT
        - PAY_PERIOD_ASSESSMENT
      title: EligibilityTrigger
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerToken:
      type: oauth2
      flows:
        password:
          scopes:
            read:all: Read all
            write:all: Write all
            read:health_check: Read health check
            write:health_check: Write health check
            read:wage_types: Read wage types
            write:wage_types: Write wage types
          tokenUrl: >-
            https://auth-preview.intermezzo.ai/authorize?audience=api-preview.intermezzo.ai

````