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

# Get Workforce Trends

> Workforce trends for Reports: headcount at each month end, joiners, leavers, voluntary and involuntary exits and the turnover rate, overall or for one group, with the same figures by department, country, entity, worker type or tenure.

Required scope: `reports:read`

## OpenAPI

````yaml api-reference/openapi.json GET /hris/get-workforce-trends
openapi: 3.1.0
info:
  title: Toku API
  version: 1.0.0
servers:
  - url: https://api.toku.com
security:
  - bearerAuth: []
paths:
  /hris/get-workforce-trends:
    get:
      operationId: getWorkforceTrends
      summary: Get Workforce Trends
      x-toku-required-scope: reports:read
      description: >-
        Workforce trends for Reports: headcount at each month end, joiners,
        leavers, voluntary and involuntary exits and the turnover rate, overall
        or for one group, with the same figures by department, country, entity,
        worker type or tenure.


        Required scope: `reports:read`
      parameters:
        - name: period
          in: query
          required: false
          schema:
            type: string
            enum:
              - LAST_6_MONTHS
              - LAST_12_MONTHS
              - LAST_24_MONTHS
        - name: breakdown
          in: query
          required: false
          schema:
            type: string
            enum:
              - DEPARTMENT
              - COUNTRY
              - ENTITY
              - WORKER_TYPE
              - TENURE
        - name: workerType
          in: query
          required: false
          schema:
            type: string
            enum:
              - ALL
              - EMPLOYEE
              - CONTRACTOR
        - name: groupKey
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 200
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWorkforceTrendsResponse'
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not found
        '409':
          description: Conflict
        '429':
          description: Response 429
components:
  schemas:
    GetWorkforceTrendsResponse:
      type: object
      properties: {}
      description: Request regeneration does not infer response shapes.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
````
