Skip to main content
GET
/
interactions
/
{interactionId}
/
status
Get Interaction Status
curl --request GET \
  --url https://api.pokulabs.com/interactions/{interactionId}/status \
  --header 'Authorization: Bearer <token>'
{
  "interactionId": "f3f7870f-30f5-4bf2-83b0-a05bc140030c",
  "status": "pending",
  "createdAt": "2026-04-28T22:30:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Authentication header containing your Poku API key. Find it in the Poku dashboard. The format is "Bearer YOUR_API_KEY"

Path Parameters

​
interactionId
string<uuid>
required

The interaction ID returned by a Poku API request.

Response

Interaction status returned successfully.

​
interactionId
string<uuid>
required

Unique identifier for the interaction.

​
status
enum<string>
required

pending means Poku is still waiting for a response or call completion. ended means the interaction is complete or its response window has expired.

Available options:
pending,
ended
​
createdAt
string<date-time>
required

When the interaction was created.

​
completionEvent
object

Present when the interaction completed with a response. The shape matches the corresponding webhook event payload.