> ## Documentation Index > Fetch the complete documentation index at: https://absentify.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Read a request by id > Read a request by id ## OpenAPI ````yaml https://api.absentify.com/api/v1/openapi.json get /requests/{id} openapi: 3.1.0 info: title: absentify CRUD API description: OpenAPI compliant REST API version: 1.0.0 servers: - url: https://api.absentify.com/api/v1 security: [] tags: - name: Departments - name: Leave types - name: Members - name: Requests - name: Public holidays - name: Workspace - name: Absences - name: Allowance Management externalDocs: url: https://absentify.com/docs/en/api-reference paths: /requests/{id}: get: tags: - Requests summary: Read a request by id description: Read a request by id operationId: request-getRequestById parameters: - in: path name: id schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ required: true responses: '200': description: Successful response content: application/json: schema: anyOf: - type: object properties: id: type: string createdAt: type: string updatedAt: type: string end: type: string start: type: string start_at: type: string enum: - morning - afternoon description: >- For day-based leave types: whether the absence starts in the `morning` (the whole first day counts) or `afternoon` (only the second half of the first day). Ignored for hour-based leave types. end_at: type: string enum: - lunchtime - end_of_day description: >- For day-based leave types: whether the absence ends at `lunchtime` (only the first half of the last day) or `end_of_day` (the whole last day counts). Ignored for hour-based leave types. leave_unit: type: string enum: - days - half_days - hours - minutes_30 - minutes_15 - minutes_10 - minutes_5 - minutes_1 request_creator_member: anyOf: - type: object properties: id: type: string custom_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' required: - id - custom_id - name - email additionalProperties: false - type: 'null' leave_type: type: object properties: name: type: string id: type: string leave_unit: type: string enum: - days - half_days - hours - minutes_30 - minutes_15 - minutes_10 - minutes_5 - minutes_1 required: - name - id - leave_unit additionalProperties: false approval_process: type: string enum: - Linear_all_have_to_agree - Linear_one_has_to_agree - Parallel_all_have_to_agree - Parallel_one_has_to_agree cancel_reason: anyOf: - type: string - type: 'null' canceld_by_member: anyOf: - type: object properties: id: type: string custom_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' required: - id - custom_id - name - email additionalProperties: false - type: 'null' requester_member: anyOf: - type: object properties: id: type: string custom_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' required: - id - custom_id - name - email additionalProperties: false - type: 'null' take_from_allowance: type: boolean allowance_type: anyOf: - type: object properties: id: type: string name: type: string ignore_allowance_limit: type: boolean allowance_unit: type: string enum: - days - hours required: - id - name - ignore_allowance_limit - allowance_unit additionalProperties: false - type: 'null' reason: anyOf: - type: string - type: 'null' workday_absence_duration: type: number duration: type: number status: type: string canceld_date: anyOf: - type: string - type: 'null' request_approvers: type: array items: type: object properties: reason: anyOf: - type: string - type: 'null' status: type: string enum: - PENDING - APPROVED - DECLINED - CANCELED - APPROVED_BY_ANOTHER_MANAGER - DECLINED_BY_ANOTHER_MANAGER - CANCELED_BY_ANOTHER_MANAGER - SKIPPED_ANOTHER_USER_APPROVED status_changed_by_member: anyOf: - type: object properties: id: type: string custom_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' required: - id - custom_id - name - email additionalProperties: false - type: 'null' status_changed_date: anyOf: - type: string - type: 'null' approver_member: anyOf: - type: object properties: id: type: string custom_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' required: - id - custom_id - name - email additionalProperties: false - type: 'null' predecessor_request_member_approver_id: anyOf: - type: string - type: 'null' required: - reason - status - status_changed_by_member - status_changed_date - approver_member - predecessor_request_member_approver_id additionalProperties: false required: - id - createdAt - updatedAt - end - start - start_at - end_at - leave_unit - request_creator_member - leave_type - approval_process - cancel_reason - canceld_by_member - requester_member - take_from_allowance - allowance_type - reason - workday_absence_duration - duration - status - canceld_date - request_approvers additionalProperties: false - type: 'null' '400': description: Invalid input data content: application/json: schema: $ref: '#/components/schemas/error.BAD_REQUEST' '401': description: Authorization not provided content: application/json: schema: $ref: '#/components/schemas/error.UNAUTHORIZED' '403': description: Insufficient access content: application/json: schema: $ref: '#/components/schemas/error.FORBIDDEN' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/error.NOT_FOUND' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR' security: - ApiKey: [] components: schemas: error.BAD_REQUEST: type: object properties: message: type: string description: The error message example: Invalid input data code: type: string description: The error code example: BAD_REQUEST issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Invalid input data error (400) description: The error information example: code: BAD_REQUEST message: Invalid input data issues: [] error.UNAUTHORIZED: type: object properties: message: type: string description: The error message example: Authorization not provided code: type: string description: The error code example: UNAUTHORIZED issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Authorization not provided error (401) description: The error information example: code: UNAUTHORIZED message: Authorization not provided issues: [] error.FORBIDDEN: type: object properties: message: type: string description: The error message example: Insufficient access code: type: string description: The error code example: FORBIDDEN issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Insufficient access error (403) description: The error information example: code: FORBIDDEN message: Insufficient access issues: [] error.NOT_FOUND: type: object properties: message: type: string description: The error message example: Not found code: type: string description: The error code example: NOT_FOUND issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Not found error (404) description: The error information example: code: NOT_FOUND message: Not found issues: [] error.INTERNAL_SERVER_ERROR: type: object properties: message: type: string description: The error message example: Internal server error code: type: string description: The error code example: INTERNAL_SERVER_ERROR issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Internal server error error (500) description: The error information example: code: INTERNAL_SERVER_ERROR message: Internal server error issues: [] securitySchemes: ApiKey: type: apiKey name: X-API-KEY in: header ````