---
title: "Get all user statuses"
method: GET
path: "/user-statuses"
tags: ["user-statuses"]
---

# Get all user statuses

`GET /user-statuses`

## Request

- Base URL: `https://api.usepylon.com`
- URL: `https://api.usepylon.com/user-statuses`
- Auth: HTTP bearer

Returns the built-in and custom user statuses for the organization. Use `slug` in a team's `assignment_configuration.assignable_user_statuses`.

**Rate limit:** 30 requests per minute

## Response `200`

- GetUserStatusesResponseBody
  - `data` UserStatus[], required: The data payload of the response.
    - `category` string, required: The category of the user status. One of active, away, out_of_office.
    - `is_archived` boolean, required: Indicates if the user status is archived.
    - `is_default_status` boolean, required: Indicates if the user status is a built-in status.
    - `label` string, required: The label of the user status.
    - `slug` string, required: The slug of the user status. Use it in a team's assignment_configuration.assignable_user_statuses.
  - `request_id` string, required: The request ID for tracking.

## Other responses

- `400`: The request was invalid or could not be completed.
- `401`: The request could not be authenticated for this API.
- `403`: The authenticated caller or organization is not allowed to access this endpoint or operation.
- `429`: The request exceeded the applicable rate limit.
- `500`: An unexpected internal error occurred.

## Changes

- **2026-10-16** `03732ec8280a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usepylon/apis/pylon-api/changes/user-statuses/get.md)

---

[API](https://skmtc.dev/usepylon/apis/pylon-api.md) - [All operations](https://skmtc.dev/usepylon/apis/pylon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usepylon/apis/pylon-api/revisions/7d018a2a6265?raw)