---
title: "List Action Attempts"
method: POST
path: "/action_attempts/list"
tags: ["/action_attempts"]
---

# List Action Attempts

`POST /action_attempts/list`

Returns a list of the [action attempts](/core-concepts/action-attempts) that you specify as an array of `action_attempt_id`s.

## Request body

- object
  - `action_attempt_ids` string[] — IDs of the action attempts that you want to retrieve.
  - `device_id` string, uuid — ID of the device to filter action attempts by.
  - `limit` integer — Maximum number of records to return per page.
  - `page_cursor` string, nullable — Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.

## Response `200`

OK

- object
  - `action_attempts` ActionAttempt[], required
    - `action_attempt_id` string, uuid, required — ID of the action attempt.
    - `action_type` string, required — Type of action being tracked.
    - `status` 'pending' | 'success' | 'error', required — Current status of the action.
    - `result` object, nullable — Result payload on success.
    - `error` object, nullable — Error details on failure.
      - `type` string
      - `message` string
  - `pagination` Pagination, required — Information about the current page of results.
    - `has_next_page` boolean, required — Indicates whether there is another page of results after this one.
    - `next_page_cursor` string, nullable, required — Opaque value that can be used to select the next page of results via the `page_cursor` parameter.
    - `next_page_url` string, uri, nullable, required — URL to get the next page of results.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/versions/00c35395ce12/schema)