---
title: "getConversationActionStatus - Get action status"
method: GET
path: "/conversations/actions/{actionId}"
tags: ["Conversations"]
---

# getConversationActionStatus - Get action status

`GET /conversations/actions/{actionId}`

## Request

- Base URL: `https://miraklconnect.com/api`
- URL: `https://miraklconnect.com/api/conversations/actions/{actionId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-connect-apis/docs/conversations/actions/:actionId/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 your asynchronous conversation action.

<div class="api-description-extension">
</div>

## Path parameters

- `actionId` string, required

## Response `200`

Action status retrieved successfully

- ConversationActionStatusResponse
  - `conversation_id` string: Identifier of the related conversation.
  - `created_at` string, date-time, required: Date and time when the action was created
  - `errors` ConversationActionErrorItem[]: List of errors if the action failed
    - `code` string, required: One of the following : - INVALID_INPUT - DATA_NOT_FOUND - UNEXPECTED - UNAVAILABLE - TOO_MANY_REQUEST
    - `message` string, required: Human-readable error message
  - `id` string, required: Unique identifier of the action
  - `status` 'PENDING' | 'SUCCESS' | 'ERROR', required: Status of an asynchronous conversation action
  - `updated_at` string, date-time, required: Date and time when the action was last updated

## Other responses

- `404`: Action not found

## Changes

- **2026-10-14** `d12b10bceb6a`: 3 warning
  - added the new `ERROR` 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/conversations/actions/:actionId/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)