---
title: "List statuses"
method: GET
path: "/statuses"
tags: ["Statuses"]
---

# List statuses

`GET /statuses`

## Request

- Base URL: `https://inboxapp.com/api/v2`
- URL: `https://inboxapp.com/api/v2/statuses`
- Auth: HTTP bearer

## Response `200`

OK

- StatusPage: Every status, in board order, in one page.
  - `data` Status[], required
    - `id` string, required
    - `name` string, required: Unique within the team, ignoring case and accents.
    - `color` string, nullable, required: A lowercase hex color.
    - `createdAt` string, date-time, required
  - `nextCursor` string, nullable, required: Pass it back as `cursor`, with the same filters, to read the next page. Null on the last page.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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