---
title: "Get action by ID"
method: GET
path: "/public/v1/actions/{actionId}"
tags: ["Actions"]
---

# Get action by ID

`GET /public/v1/actions/{actionId}`

Retrieves detailed information about a specific action.

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/12345
```

**Response:**
Returns comprehensive action details including description, creator, action items, skip information, and attachment metadata.

**Action ID:**
The `actionId` is a **stable identifier** that uniquely identifies an action. Once created, it never changes, making it safe for:
- Storing in your database for future reference
- Using in URLs and bookmarks
- External references and integrations

To find action IDs, use [`GET /public/v1/actions`](#/Actions/listActions) to list all actions and retrieve their `actionId` values.

**Related Operations:**
- `GET /public/v1/actions` - List all actions (to find actions by other criteria)

**Required Permission:** `access_public_actions`

## Path parameters

- `actionId` integer, required

## Response `200`

Action found and returned successfully

- PublicActionDetailDTO — Public API v1 DTO for detailed action response
  - `actionId` integer, required — Public-facing action key
  - `title` string, required — Action title
  - `description` string, nullable — Action description
  - `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
  - `creator` PublicUserRefDTO, required — User reference information
    - `id` integer, required — User ID
    - `name` string, required — User full name
    - `email` string, nullable — User email
  - `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)
  - `mainItem` PublicActionItemDTO — Action item information
    - `id` integer, required — Item ID
    - `type` string, required — Item type
    - `entityId` integer, nullable — Entity ID this item references
  - `executionItem` PublicActionItemDTO — Action item information
    - `id` integer, required — Item ID
    - `type` string, required — Item type
    - `entityId` integer, nullable — Entity ID this item references
  - `attachmentItems` PublicActionItemDTO[], required — Attachment items
    - `id` integer, required — Item ID
    - `type` string, required — Item type
    - `entityId` integer, nullable — Entity ID this item references
  - `skipInfo` PublicActionSkipDTO — Action skip information
    - `reason` string, required — Skip reason
    - `otherText` string, nullable — Additional reason text
    - `endDate` string, date-time, nullable — End date for skip (ISO 8601 timestamp)

## 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 with the specified actionId 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)