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

# List requests

> Returns a paginated list of requests for the authenticated company.



## OpenAPI

````yaml GET /request/v1/requests
openapi: 3.0.0
info:
  description: ''
  version: 3.0.0
  title: Sesame Public API
servers:
  - url: https://api-{region}.sesametime.com
    variables:
      region:
        default: eu1
security: []
tags: []
paths:
  /request/v1/requests:
    get:
      tags:
        - Requests
      summary: List requests
      description: Returns a paginated list of requests for the authenticated company.
      operationId: ListRequests
      parameters:
        - name: status
          in: query
          description: Filter by status (exact match)
          schema:
            type: string
            enum:
              - pending
              - accepted
              - rejected
        - name: status[in]
          in: query
          description: Filter by multiple statuses
          schema:
            type: array
            items:
              type: string
              enum:
                - pending
                - accepted
                - rejected
        - name: requestTypeId[in]
          in: query
          description: Filter by request type IDs
          schema:
            type: array
            items:
              type: string
              format: uuid
        - in: query
          name: employeeId
          description: Filter by employee ID
          schema:
            type: string
            format: uuid
        - name: createdAt[gte]
          in: query
          description: Filter by created date (greater than or equal)
          schema:
            type: string
            format: date
            example: '2024-01-01'
        - name: createdAt[lte]
          in: query
          description: Filter by created date (less than or equal)
          schema:
            type: string
            format: date
            example: '2024-12-31'
        - in: query
          name: page
          description: Page number
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: Items per page (max 500)
          schema:
            type: integer
            default: 50
            maximum: 500
      responses:
        '200':
          description: Successful response - List of requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: The request ID
                        title:
                          type: string
                          description: The title of the request
                          example: Vacation request
                        status:
                          type: string
                          enum:
                            - pending
                            - accepted
                            - rejected
                          description: The current status of the request
                        employeeId:
                          type: string
                          format: uuid
                          description: The ID of the employee who created the request
                        requestType:
                          type: object
                          description: The type of request
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: The request type ID
                            name:
                              type: string
                              description: The name of the request type
                              example: Vacation
                            icon:
                              type: string
                              description: The icon identifier for the request type
                              example: vacation
                        createdAt:
                          type: string
                          format: Y-m-dTH:i:sP
                          example: '2020-01-01T10:00:00+01:00'
                        updatedAt:
                          type: string
                          format: Y-m-dTH:i:sP
                          example: '2020-01-01T10:00:00+01:00'
                        resolvedAt:
                          type: string
                          format: date-time
                          nullable: true
                          description: >-
                            The date when the request was resolved (accepted or
                            rejected)
                          example: '2024-01-15T14:30:00+01:00'
                        resolvedById:
                          type: string
                          format: uuid
                          nullable: true
                          description: The ID of the employee who resolved the request
                        flowTotalLevels:
                          type: integer
                          nullable: true
                          description: Total number of approval levels in the workflow
                          example: 3
                        flowCurrentLevel:
                          type: integer
                          nullable: true
                          description: Current approval level in the workflow
                          example: 2
                        answers:
                          type: array
                          description: Form answers associated with the request
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                description: The answer ID
                              questionId:
                                type: string
                                format: uuid
                                description: The question ID
                              questionName:
                                type: string
                                nullable: true
                                description: The name/title of the question
                                example: Start date
                              questionType:
                                type: string
                                nullable: true
                                description: >-
                                  The type of the question (text, date, radio,
                                  check, etc.)
                                example: date
                              value:
                                type: string
                                nullable: true
                                description: >-
                                  The answer value. For radio/check questions,
                                  option UUIDs are resolved to their labels
                                example: '2024-01-15'
                  meta:
                    type: object
                    properties:
                      currentPage:
                        type: integer
                        example: 1
                      lastPage:
                        type: integer
                        example: 1
                      total:
                        type: integer
                        example: 1
                      perPage:
                        type: integer
                        example: 1
        '401':
          description: Unauthorized - Invalid or missing API Key
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message indicating authentication failure
                    example: Invalid or missing API Key
                  code:
                    type: string
                    description: Error code for programmatic handling
                    example: UNAUTHORIZED
              example:
                message: Invalid or missing API Key
                code: UNAUTHORIZED
        '429':
          description: Too Many Requests - Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message indicating rate limit exceeded
                    example: Rate limit exceeded. Please try again later.
                  code:
                    type: string
                    description: Error code for programmatic handling
                    example: RATE_LIMIT_EXCEEDED
                  retryAfter:
                    type: integer
                    description: Number of seconds to wait before retrying
                    example: 60
              example:
                message: Rate limit exceeded. Please try again later.
                code: RATE_LIMIT_EXCEEDED
                retryAfter: 60
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````