---
title: "v2-getActionStatus - Track an asynchronous action request"
method: GET
path: "/v2/orders/actions/{action_id}"
tags: ["Orders"]
---

# v2-getActionStatus - Track an asynchronous action request

`GET /v2/orders/actions/{action_id}`

## Request

- Base URL: `https://miraklconnect.com/api`
- URL: `https://miraklconnect.com/api/v2/orders/actions/{action_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-connect-apis/docs/v2/orders/actions/:action_id/get.ts> (a function with typed inputs; its response is checked against the schema)

<div class="extension-title">Description</div>

Use this API to check the status of an asynchronous action request  (e.g., `v2-acceptOrderLines`) and retrieve  any potential errors that occurred during the action processing.
We recommend integrating this API asynchronously.

<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: Asynchronous: every 5 minutes per action ID</div>
<div class="max-call-frequency">Maximum usage: Asynchronous: once per minute per action ID</div>
</div>

## Path parameters

- `action_id` string, required

## Response `200`

Details of the action, including current status and potential errors

- ActionResponse
  - `created_at` string, date-time, required: Action creation date
  - `errors` ActionErrorResponse[]: List of errors that occurred during the action processing
    - `code` string, required: Error code. One of this values : - <code>INVALID_INPUT</code> - <code>DATA_NOT_FOUND</code> - <code>UNEXPECTED</code> - <code>UNAVAILABLE</code> - <code>TOO_MANY_REQUEST</code> - <code>ACTION_NOT_SUPPORTED</code> - <code>ORDER_IN_WRONG_STATE</code> - <code>INVALID_PRODUCT_ID</code> - <code>OUT_OF_STOCK</code> - <code>RETURN_IN_WRONG_STATE</code> - <code>ORDER_FULFILLED_BY_PARTNER</code> - <code>PAYMENT_REQUIRED</code> - <code>SYNCHRONIZATION_DEACTIVATED</code> - <code>CARRIER_NOT_SUPPORTED</code> - <code>MISSING_CARRIER</code> - <code>WAREHOUSE_ID_NOT_FOUND</code> - <code>WAREHOUSE_ID_REQUIRED</code> - <code>OTHER</code>
    - `message` string, required: Original order error message from the Marketplace
  - `id` string, required: The unique identifier for the asynchronous action. This ID is generated when the action is initially requested.
  - `status` 'PENDING' | 'SUCCESS' | 'FAILED', required: Current action status
  - `updated_at` string, date-time, required: Date of last modification of the action status

## Other responses

- `404`: No matching action ID was found. The requested action does not exist.

## Changes

- **2026-10-14** `d12b10bceb6a`: 3 warning
  - added the new `FAILED` enum value to the `status` response property for the response status `200`
  - added the new `PENDING` enum value to the `status` response property for the response status `200`
  - added the new `SUCCESS` enum value to the `status` response property for the response status `200`

[Operation history](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/changes/v2/orders/actions/:action_id/get.md)

---

[API](https://skmtc.dev/mirakl/apis/mirakl-connect-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/revisions/c0527a972b89?raw)