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

# Statuses

> List room status definitions configured in your organization.

## Endpoints

| Method | Path               | Description        |
| ------ | ------------------ | ------------------ |
| `GET`  | `/api/v2/statuses` | List room statuses |

***

## List room statuses

`GET /api/v2/statuses`

Returns all room statuses available in the organization. Use a returned `id` as `statusId` when creating or updating a room.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.flowla.com/api/v2/statuses \
    -H "x-flowla-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.flowla.com/api/v2/statuses",
      headers={"x-flowla-api-key": "YOUR_API_KEY"},
  )
  print(response.json())
  ```

  ```js JavaScript theme={null}
  const res = await fetch("https://api.flowla.com/api/v2/statuses", {
    headers: { "x-flowla-api-key": "YOUR_API_KEY" },
  });
  const statuses = await res.json();
  ```
</CodeGroup>

### Response

<ResponseField name="id" type="string">
  Status identifier. Use this as `statusId` when creating or updating a room.
</ResponseField>

<ResponseField name="title" type="string">
  Display name of the status.
</ResponseField>

<ResponseField name="defaultStatus" type="boolean">
  `true` if this status is automatically assigned to new rooms.
</ResponseField>

```json Response 200 theme={null}
[
  { "id": "st_01ab2", "title": "In Progress", "defaultStatus": true },
  { "id": "st_01xy9", "title": "Closed Won", "defaultStatus": false }
]
```

<Note>
  Colors and other visual metadata are not included in the API response.
</Note>