> ## 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.

# Get a time-off request

> One request, as much of it as the caller may see. An admin, the employee who asked and the current or an earlier approver get all of it — note, approvers, documents. Anyone else gets an approved request without those, the way it appears on the calendar. `404` when the request does not exist or the caller may not see it. Requires the `time-off:read` scope.



## OpenAPI

````yaml /openapi.json get /time-off/requests/{id}
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/requests/{id}:
    get:
      tags:
        - Time off requests
      summary: Get a time-off request
      description: >-
        One request, as much of it as the caller may see. An admin, the employee
        who asked and the current or an earlier approver get all of it — note,
        approvers, documents. Anyone else gets an approved request without
        those, the way it appears on the calendar. `404` when the request does
        not exist or the caller may not see it. Requires the `time-off:read`
        scope.
      operationId: timeOff.get
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  status:
                    enum:
                      - approved
                      - pending
                      - declined
                      - canceled
                    type: string
                  policy_id:
                    type: string
                    format: uuid
                  policy:
                    type: object
                    properties:
                      name:
                        type: string
                      is_approval_required:
                        type: boolean
                    required:
                      - name
                      - is_approval_required
                    additionalProperties: {}
                  start_date:
                    type: string
                    format: date
                  start_date_type:
                    enum:
                      - FULL_DAY
                      - AM
                      - PM
                    type: string
                  end_date:
                    type: string
                    format: date
                  end_date_type:
                    enum:
                      - FULL_DAY
                      - AM
                      - PM
                    type: string
                  amount:
                    type: number
                  note:
                    anyOf:
                      - type: string
                      - type: 'null'
                  requested_at:
                    anyOf:
                      - type: string
                      - type: 'null'
                  approvers:
                    type: array
                    items:
                      type: object
                      properties:
                        approver:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            display_name:
                              type: string
                            email:
                              anyOf:
                                - type: string
                                - type: 'null'
                          required:
                            - id
                            - display_name
                            - email
                          additionalProperties: {}
                        status:
                          enum:
                            - approved
                            - pending
                            - declined
                            - canceled
                          type: string
                        level_order:
                          type: number
                        decisioned_at:
                          anyOf:
                            - type: string
                            - type: 'null'
                        note:
                          anyOf:
                            - type: string
                            - type: 'null'
                      required:
                        - approver
                        - status
                        - level_order
                        - decisioned_at
                        - note
                      additionalProperties: {}
                  time_off_documents:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        file_path:
                          type: string
                        kind:
                          enum:
                            - request
                            - approval
                            - decline
                            - attachment
                          type: string
                      required:
                        - name
                        - file_path
                      additionalProperties: {}
                required:
                  - id
                  - status
                  - policy_id
                  - policy
                  - start_date
                  - start_date_type
                  - end_date
                  - end_date_type
                  - amount
                  - note
                  - requested_at
                  - approvers
                  - time_off_documents
                additionalProperties: {}
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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