---
title: "List Review Actions"
method: GET
path: "/actions/reviews/"
tags: ["Actions"]
---

# List Review Actions

`GET /actions/reviews/`

Retrieve a list of review actions accessible to the authenticated user. Review actions document state transitions or user comments related specifically to reviewable resources, like preprints.
Supports pagination and filtering by:
  - `id`
  - `trigger`
  - `from_state`
  - `to_state`
  - `date_created`
  - `date_modified`

Pagination follows the [JSON:API pagination specification](https://jsonapi.org/format/#fetching-pagination).
#### Permissions

 - User must be authenticated and have permissions to view actions associated with the respective resources.

#### Errors
If unsuccessful, returns an `errors` object. See [Errors and Error Codes](#tag/Errors-and-Error-Codes).

## Query parameters

- `page` integer
- `per_page` integer
- `filter[id]` string
- `filter[trigger]` string
- `filter[from_state]` string
- `filter[to_state]` string
- `filter[date_created]` string
- `filter[date_modified]` string

## Response `200`

Successful retrieval of review actions.

- object
  - `data` object[]
    - `id` string, required — A unique identifier representing the action.
    - `type` 'review-actions' | 'node-request-actions' | 'preprint-request-actions' | 'registration-actions' | 'schema-response-actions' | 'collection-submission-actions', required — Specifies the resource type of the action, indicating the workflow it belongs to.
    - `attributes` object, required
      - `trigger` string, required — The event that initiated this action, representing workflow triggers such as: - `submit`: Submitting for review - `accept`: Accepting the submission - `reject`: Rejecting the submission - `withdraw`: Withdrawing the submission - `edit_comment`: Editing an existing comment
      - `comment` string — Optional explanatory comment provided by the user who triggered the action, offering context or justification.
      - `from_state` string, required — The state of the resource immediately before the action occurred, e.g., `pending`, `initial`, `accepted`, `rejected`.
      - `to_state` string, required — The state of the resource immediately after the action occurred, e.g., `accepted`, `rejected`, `withdrawn`.
      - `date_created` string, date-time, required — Timestamp when the action was first created.
      - `date_modified` string, date-time, required — Timestamp when the action was last modified.
      - `auto` boolean — Indicates whether the action was system-generated (`true`) or manually performed by a user (`false`).
      - `visible` boolean — Controls the visibility of the action. Visible (`true`) actions are accessible to general users, while non-visible (`false`) actions are restricted to administrators or moderators.
    - `relationships` object, required
      - `creator` object, required — Information about the user who initiated the action.
        - `links` object
          - `related` object
            - `href` string, uri
            - `meta` object
        - `data` object
          - `id` string
          - `type` string
      - `target` object, required — The resource (e.g., preprint, registration, schema response) directly affected by this action.
        - `links` object
          - `related` object
            - `href` string, uri
            - `meta` object
        - `data` object
          - `id` string
          - `type` string
      - `provider` object, required — The provider managing the moderation or review process associated with the action's target resource.
        - `links` object
          - `related` object
            - `href` string, uri
            - `meta` object
        - `data` object
          - `id` string
          - `type` string
    - `links` object
      - `self` string, uri — Direct URL to access detailed information about this action.
  - `meta` object
    - `total` integer — Total number of actions available.
    - `per_page` integer — Number of actions per page.
    - `version` string — API version.
  - `links` object
    - `self` string, uri — Link to the current page of results.
    - `next` string, uri — Link to the next page of results.
    - `prev` string, uri — Link to the previous page of results.

## Other responses

- `400` — Bad request. Invalid filter or pagination parameters.
- `403` — Forbidden. The user does not have permission to view these review actions.

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/revisions/ca701048eb0d/schema)