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

# Who is off between two dates

> The time off overlapping `from`–`to` (YYYY-MM-DD), with the same visibility as the dashboard calendar: a member sees colleagues' approved time off plus their own and the requests they approve; an admin sees everything. Each block is lean — open one with `GET /time-off/requests/{id}`. `employees` lists everyone shown on the calendar, including those with no time off. Narrow with comma-separated `employee_ids`, `department_ids` and `site_ids`. Requires the `time-off:read` scope.



## OpenAPI

````yaml /openapi.json get /time-off/absences
openapi: 3.1.1
info:
  title: A-Char API
  version: 1.0.0
  description: 'Authenticate with `Authorization: Bearer <api key>`.'
servers:
  - url: https://a-char.com/api/v1
security:
  - bearerAuth: []
paths:
  /time-off/absences:
    get:
      tags:
        - Time off requests
      summary: Who is off between two dates
      description: >-
        The time off overlapping `from`–`to` (YYYY-MM-DD), with the same
        visibility as the dashboard calendar: a member sees colleagues' approved
        time off plus their own and the requests they approve; an admin sees
        everything. Each block is lean — open one with `GET
        /time-off/requests/{id}`. `employees` lists everyone shown on the
        calendar, including those with no time off. Narrow with comma-separated
        `employee_ids`, `department_ids` and `site_ids`. Requires the
        `time-off:read` scope.
      operationId: timeOff.absences
      parameters:
        - name: from
          in: query
          required: true
          schema:
            type: string
            format: date
          allowEmptyValue: true
          allowReserved: true
        - name: to
          in: query
          required: true
          schema:
            type: string
            format: date
          allowEmptyValue: true
          allowReserved: true
        - name: employee_ids
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: deepObject
          explode: true
          allowEmptyValue: true
          allowReserved: true
        - name: department_ids
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: deepObject
          explode: true
          allowEmptyValue: true
          allowReserved: true
        - name: site_ids
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: deepObject
          explode: true
          allowEmptyValue: true
          allowReserved: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  from:
                    type: string
                    format: date
                  to:
                    type: string
                    format: date
                  employees:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        first_name:
                          type: string
                        middle_name:
                          anyOf:
                            - type: string
                            - type: 'null'
                        last_name:
                          type: string
                        display_name:
                          type: string
                        email:
                          type: string
                        image_url:
                          anyOf:
                            - type: string
                            - type: 'null'
                        status:
                          enum:
                            - active
                            - inactive
                            - not_started
                          type: string
                      required:
                        - id
                        - first_name
                        - middle_name
                        - last_name
                        - display_name
                        - email
                        - image_url
                        - status
                      additionalProperties: {}
                  blocks:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        employee_id:
                          type: string
                          format: uuid
                        policy_id:
                          type: string
                          format: uuid
                        policy:
                          type: object
                          properties:
                            name:
                              type: string
                            color:
                              enum:
                                - cyan
                                - sky
                                - blue
                                - indigo
                                - pink
                                - rose
                                - red
                                - lime
                                - green
                                - emerald
                                - teal
                                - purple
                                - violet
                                - yellow
                                - orange
                                - amber
                                - gray
                                - zinc
                              type: string
                          required:
                            - name
                            - color
                          additionalProperties: {}
                        start_date:
                          type: string
                        start_date_type:
                          enum:
                            - FULL_DAY
                            - AM
                            - PM
                          type: string
                        end_date:
                          type: string
                        end_date_type:
                          enum:
                            - FULL_DAY
                            - AM
                            - PM
                          type: string
                        status:
                          enum:
                            - approved
                            - pending
                            - declined
                            - canceled
                          type: string
                      required:
                        - id
                        - employee_id
                        - policy_id
                        - policy
                        - start_date
                        - start_date_type
                        - end_date
                        - end_date_type
                        - status
                      additionalProperties: {}
                required:
                  - from
                  - to
                  - employees
                  - blocks
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.