---
title: "List action statuses for type"
method: GET
path: "/public/v1/actions/statuses"
tags: ["Actions"]
---

# List action statuses for type

`GET /public/v1/actions/statuses`

Retrieves a list of action statuses that are valid for a specific action type.

For detailed information about actions, action types, and action statuses, see the [Prewave Help Center](https://help.prewave.com/en/articles/258470-action-planner-action-dashboard-action-status-and-action-types).

**Quick Start:**
```
GET /public/v1/actions/statuses?typeId=5
```

**Response Format:**
Returns only the statuses that are valid for the specified action type. This is essential for:
- Building type-specific status selection UI components
- Understanding which statuses can be assigned to actions of a specific type

**Status Transitions:**
Each action type has a defined set of valid statuses.

**Use Cases:**
- Discover valid statuses for a specific action type
- Build dynamic UI that only shows valid statuses for each action type

**Finding Action Type IDs:**
Use `GET /public/v1/actions/types` to find valid `typeId` values.

**Related Operations:**
- `GET /public/v1/actions/types` - List all available action types
- `GET /public/v1/actions/statuses` - List all statuses (not filtered by type)

**Required Permission:** `access_public_actions`

## Query parameters

- `typeId` integer, required

## Response `200`

Successfully retrieved action statuses for the specified type

- PublicActionStatusDTO[]
  - `id` integer, required — Status ID
  - `title` string, required — Status title
  - `state` string, required — Status state

## Other responses

- `403` — 403 Forbidden - Authentication or authorization failure. This status code is returned when: (1) the request lacks valid authentication credentials (missing or invalid X-Auth-Token header), or (2) the authenticated user does not have the required permission to access this resource.
- `404` — 404 Not Found - The action type with the specified ID was not found or is not accessible to your organization.
- `429` — 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success.
- `500` — 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed.

---

[API](https://skmtc.net/prewave/apis/public-prewave-api.md) · [All operations](https://skmtc.net/prewave/apis/public-prewave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prewave/public-prewave-api/revisions/466169815b78/schema)