Skip to contentSkip to navigationSkip to topbar
Twilio Docs

Get Action Status

(information)

Legal information

Conversation Orchestrator, including the APIs, may use artificial intelligence or machine learning technologies and is subject to the terms of the Predictive and Generative AI/ML Features Addendum(link takes you to an external page). For details on AI usage and data, see the AI Nutrition Facts for Real-Time Transcription and Conversation Relay.

Conversation Orchestrator is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI.

Conversations products are only available in the new Twilio Console(link takes you to an external page). If your account hasn't been migrated, you'll be redirected to the legacy Console where these products won't appear.

GET/v2/Conversations/{ConversationId}/Actions/{ActionId}

Base url: https://conversations.twilio.com (base url)

Retrieve the current status of an Action.

Request

fetch-conversation-action-request page anchor

Authentication

authentication page anchor

Path parameters

fetch-conversation-action-path-parameters page anchor
Property nameTypeRequiredPIIDescription
conversationIdstring
required
Not PII
actionIdstring
required
Not PII

Responses

fetch-conversation-action-responses page anchor
200400404429500503

Action status.

SchemaExample
Property nameTypeRequiredPIIDescriptionChild properties
idstring

Optional

Not PII

Unique identifier for this Action.

Example: conv_action_01k1etx3jbfx88476ccja0889e
typestring

Optional

Not PII

The type of action. Accepted values: SEND_MESSAGE.

Example: SEND_MESSAGE
statusenum<string>

Optional

Not PII

Current status of the Action.

  • PENDING: Action accepted, awaiting downstream confirmation
  • COMPLETED: Downstream backend confirmed the action
  • FAILED: Downstream backend reported a failure
Example: PENDINGPossible values:
PENDINGCOMPLETEDFAILED
conversationIdstring

Optional

Not PII

The conversation this action belongs to.

Example: conv_conversation_01k1etx3jbfx88476ccja0889c
relatedobject

Optional

Not PII

Named identifiers from downstream. For SEND_MESSAGE:

  • messageSid: The downstream message SID (present when PENDING or COMPLETED)
  • communicationId: The Communication ID (present when COMPLETED)
Example: {"messageSid":"SM1234567890abcdef1234567890abcdef","communicationId":"conv_communication_01k1etx3jbfx88476ccja0889c"}
createdAtstring<date-time>

Optional

Not PII

Timestamp when the action was created.

Example: 2026-03-30T10:30:00Z
updatedAtstring<date-time>

Optional

Not PII

Timestamp when the action was last updated.

Example: 2026-03-30T10:30:02Z
completedAtstring<date-time>

Optional

Not PII

Timestamp when the action reached a terminal status.

Example: 2026-03-30T10:30:02Z
Get Action StatusLink to code sample: Get Action Status
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID and Auth Token at twilio.com/console

5
// and set the environment variables. See http://twil.io/secure

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function fetchConversationAction() {

11
  const action = await client.conversations.v2

12
    .actions("ConversationId", "ActionId")

13
    .fetch();

14


15
  console.log(action.id);

16
}

17


18
fetchConversationAction();

Response

Note about this response
1
{

2
  "completedAt": "2009-07-06T20:30:00Z",

3
  "conversationId": "conversationId",

4
  "createdAt": "2009-07-06T20:30:00Z",

5
  "id": "id",

6
  "related": {},

7
  "status": "PENDING",

8
  "type": "type",

9
  "updatedAt": "2009-07-06T20:30:00Z"

10
}