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

# List actions

`GET /public/v1/actions`

Retrieves a paginated list of actions with filtering and sorting capabilities.

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?page=0&size=20
```

**Response Format:**
Returns a lightweight summary view optimized for list/table displays. For complete action details including full descriptions, action items, and attachment metadata, use `GET /public/v1/actions/{actionId}`.

**Filtering:**
All filter parameters are optional and can be combined. Multiple values are passed as comma-separated lists (e.g., `typeIds=5,6,7`).

**Finding Valid Filter Values:**
- **Target IDs**: Use `GET /public/v2/suppliers/sites` to get valid `prewaveTargetId` values
- **Action Types & Status IDs**: Use [`GET /public/v1/actions/types`](#/Actions/listActionTypes) to get valid action type IDs and [`GET /public/v1/actions/statuses`](#/Actions/listActionStatuses) to get valid status IDs
- **Team IDs & User IDs**: Available in your organization's team and user management interfaces

**Performance:**
- Response payloads are optimized for list views (60-80% smaller than full detail responses)
- Using multiple filters may impact query performance
- Text search (`query` parameter) searches across title and description fields
- Date range filters are inclusive (both endpoints included)
- Use pagination (`page`, `size`) to limit response size for large result sets

**Required Permission:** `access_public_actions`

## Query parameters

- `page` integer
- `size` integer
- `sort` string[]
- `typeIds` integer[]
- `statusIds` integer[]
- `targetIds` integer[]
- `assigneeIds` integer[]
- `teamIds` integer[]
- `organizationIds` integer[]
- `dueDateFrom` string, date-time
- `dueDateTo` string, date-time
- `createdAtFrom` string, date-time
- `createdAtTo` string, date-time
- `updatedAtFrom` string, date-time
- `updatedAtTo` string, date-time
- `query` string

## Response `200`

Successfully retrieved actions

- SchemaPublicActionDTO
  - `totalPages` integer
  - `totalElements` integer
  - `size` integer
  - `content` PublicActionDTO[]
    - `actionId` integer, required — Public-facing action key
    - `title` string, required — Action title
    - `type` PublicActionTypeDTO, required — Action type information
      - `id` integer, required — Action type ID
      - `displayName` string, required — Action type display name
    - `status` PublicActionStatusDTO, required — Action status information
      - `id` integer, required — Status ID
      - `title` string, required — Status title
      - `state` string, required — Status state
    - `target` PublicTargetRef, required — Reference to a target (supplier/site)
      - `id` integer, required — Prewave Target ID
      - `name` string, required — Target name
    - `assignees` PublicUserRefDTO[], required — Assigned users
      - `id` integer, required — User ID
      - `name` string, required — User full name
      - `email` string, nullable — User email
    - `teams` PublicTeamRefDTO[], required — Assigned teams
      - `id` integer, required — Team ID
      - `name` string, required — Team name
    - `organization` PublicTargetRef — Reference to a target (supplier/site)
      - `id` integer, required — Prewave Target ID
      - `name` string, required — Target name
    - `dueDate` string, date-time, nullable — Due date (ISO 8601 timestamp)
    - `createdAt` string, date-time, required — Creation timestamp (ISO 8601 timestamp)
    - `updatedAt` string, date-time, required — Last update timestamp (ISO 8601 timestamp)
  - `number` integer
  - `first` boolean
  - `last` boolean
  - `numberOfElements` integer
  - `sort` SortObject
    - `empty` boolean
    - `sorted` boolean
    - `unsorted` boolean
  - `pageable` Pageable
    - `page` integer
    - `size` integer
    - `sort` string[]
  - `empty` boolean

## 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.
- `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)