# List statuses

`GET /api/status`

URL: https://repsona.com/api/get-status

Returns statuses available in the current space or project.

## Parameters

| name | in | type | required | description |
| --- | --- | --- | --- | --- |
| `projectId` | query | "@all" \| integer | required | The ID of the project to list statuses for, or `@all` for every project you belong to. |

## Request

```sh
curl -X GET "https://<space>.repsona.com/api/status" \
  -H "Authorization: Bearer $REPSONA_API_KEY"
```

## Responses

- 200: Statuses for the requested scope
- 400: Invalid query parameters
- 401: Authentication is required

## Example response

```json
{
  "projectId": 253,
  "spaceId": 541,
  "statuses": [
    {
      "id": 166,
      "name": "To do",
      "color": "#64748b",
      "sortOrder": 0,
      "isClosed": false,
      "projectId": 253
    },
    {
      "id": 172,
      "name": "In review",
      "color": "#f59e0b",
      "sortOrder": 1000,
      "isClosed": false,
      "projectId": 253
    }
  ]
}
```