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

# List time off requests

> Lists pending time-off requests across orgs the token member manages.

Includes items with `type = time_off` and `status = pending` from active
organizations where the authenticated member's `permission_set_id` is
owner, general manager, or manager. Results are paginated with `limit` and
`offset`. See [Pagination](https://docs.breakroomapp.com/guides/pagination.md).

**orgId** `string`

Hashed org ID. Must be an active org where the token member is owner,
general manager, or manager.

**assigneeId** `string`

Hashed assignee org-member ID.

**limit** `number` (default: 50)

Page size (clamped to 1–200).

**offset** `number` (default: 0)

Zero-based offset into the ordered result set.

## Response

**data** `object[]` *required*

Page of pending time-off items.

**properties**

**id** `string` *required*

Hashed event ID. UUID values are returned unchanged.

**orgId** `string` *required*

Hashed organization ID.

**assigneeId** `string` *required*

Hashed assignee org-member ID.

**assignee** `object`

Assignee's org-member profile.

**properties**

**id** `string` *required*

Hashed assignee org-member ID.

**name** `string`

Display name.

**firstName** `string`

First name.

**lastName** `string`

Last name.

**archived** `string`

Archive marker, when set.

**locId** `string`

Hashed location ID, when set.

**status** `string` *required*

Always `pending` for this endpoint.

**startDatetime** `string` *required*

ISO 8601 start datetime.

**endDatetime** `string` *required*

ISO 8601 end datetime.

**notes** `string`

Optional notes.

**type** `string` *required*

Always `time_off` for this endpoint.

**createdBy** `string`

Hashed creator org-member ID.

**extraData** `object`

Additional data, when present.

**hasMore** `boolean` *required*

`true` if more results exist after this page.

## Errors

| Status | When |
| - | - |
| `401` | Authentication failed |
| `403` | Authenticated but not allowed to access the resource |

```bash Request theme={null}
curl https://api.breakroomapp.com/functions/v1/get-time-off-requests \
  -H "Authorization: Bearer $BREAKROOM_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"limit":50,"offset":0}'
```

```json Pending requests theme={null}
{ "limit": 50, "offset": 0 }
```

```json Filter by org theme={null}
{ "orgId": "org_3hd8w1zt", "limit": 25 }
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "evt_x5p7l3tg",
      "orgId": "org_3hd8w1zt",
      "assigneeId": "orm_7k2m9xqp",
      "assignee": {
        "id": "orm_7k2m9xqp",
        "name": "Jane Doe",
        "firstName": "Jane",
        "lastName": "Doe",
        "archived": null
      },
      "locId": "loc_9fq2c6jb",
      "status": "pending",
      "startDatetime": "2026-01-10T00:00:00Z",
      "endDatetime": "2026-01-12T23:59:59Z",
      "notes": "Vacation",
      "type": "time_off",
      "createdBy": "orm_a4n8r2ve",
      "extraData": null
    }
  ],
  "hasMore": false
}
```


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