Skip to main content
GET
/
{projectSlug}
/
statuses
List statuses
curl --request GET \
  --url https://api.elean.app/v1/public/{projectSlug}/statuses \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "018e1b2c-aaaa-0000-0000-000000000001",
    "name": "Backlog",
    "color": "#6b7280",
    "category": "todo",
    "order": 1
  },
  {
    "id": "018e1b2c-aaaa-0000-0000-000000000002",
    "name": "In Review",
    "color": "#f59e0b",
    "category": "in_progress",
    "order": 2
  },
  {
    "id": "018e1b2c-aaaa-0000-0000-000000000003",
    "name": "Done",
    "color": "#22c55e",
    "category": "done",
    "order": 3
  }
]

Authorizations

​
Authorization
string
header
required

API key created in Workspace Settings → API Keys. Pass it in the Authorization header as a Bearer token, or in the X-API-Key header.

Format: el_ followed by 40 hex characters.

Path Parameters

​
projectSlug
string
required

The slug of the project.

Example:

"my-project"

Response

A list of custom statuses.

​
id
string<uuid>

Unique identifier of the status. Use this as statusId when creating or filtering tasks.

Example:

"018e1b2c-aaaa-0000-0000-000000000002"

​
name
string

Display name of the status.

Example:

"In Review"

​
color
string | null

Hex color code for the status, or null if not set.

Example:

"#f59e0b"

​
category
enum<string>

Semantic category of the status. Used for broad filtering via the status query parameter.

Available options:
todo,
in_progress,
done
Example:

"in_progress"

​
order
integer

Display order within the project.

Example:

2