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

# List Requests

> Get a paginated list of time-off requests

Retrieve a paginated list of all time-off requests in your workspace. You can filter by status or by a specific user's ID.

## Request

```bash theme={null}
curl -X GET "https://api.series.hr/time-off/list?page=1&limit=10" \
  -H "apikey: YOUR_API_KEY"
```

## Parameters

<ParamField query="page" type="integer">
  Page number (default: 1)
</ParamField>

<ParamField query="limit" type="integer">
  Number of items per page (default: 10, max: 50)
</ParamField>

<ParamField query="status" type="string">
  Filter by status (e.g. `pending`, `accepted`, `ongoing`, `denied`, `cancelled`, `completed`)
</ParamField>

<ParamField query="requesterId" type="string">
  Filter by the Roblox user ID of the requester
</ParamField>

## Response

<ResponseField status={200} name="200">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "WorkspaceId": "a7d5339a-5531-4336-99c6-6f3249c9ac20",
      "Page": 1,
      "Requests": [
        {
          "RequestId": "req-12345",
          "WorkspaceId": "a7d5339a-5531-4336-99c6-6f3249c9ac20",
          "RequesterId": "714760171",
          "Start": "2025-10-19T09:00:00.000Z",
          "End": "2025-10-21T17:00:00.000Z",
          "Importance": "medium",
          "Reason": "Going on vacation",
          "Status": "accepted",
          "HandledBy": "123456789",
          "ManagerNote": "Enjoy your trip!",
          "CreatedAt": "2025-10-01T12:00:00.000Z",
          "UpdatedAt": "2025-10-02T15:30:00.000Z"
        }
      ],
      "Pagination": {
        "CurrentPage": 1,
        "TotalPages": 1,
        "TotalRequests": 1,
        "RequestsPerPage": 10,
        "HasNextPage": false,
        "HasPreviousPage": false
      }
    }
  }
  ```
</ResponseField>