Get Interaction Status
curl --request GET \
--url https://api.pokulabs.com/interactions/{interactionId}/status \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pokulabs.com/interactions/{interactionId}/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pokulabs.com/interactions/{interactionId}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pokulabs.com/interactions/{interactionId}/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pokulabs.com/interactions/{interactionId}/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pokulabs.com/interactions/{interactionId}/status")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pokulabs.com/interactions/{interactionId}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"interactionId": "f3f7870f-30f5-4bf2-83b0-a05bc140030c",
"status": "pending",
"createdAt": "2026-04-28T22:30:00.000Z"
}Interactions
Get Interaction Status
Returns the current status for an interaction. Use this to poll an interaction created by an async request, such as an outbound call placed with waitForCallEnd set to false.
GET
/
interactions
/
{interactionId}
/
status
Get Interaction Status
curl --request GET \
--url https://api.pokulabs.com/interactions/{interactionId}/status \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pokulabs.com/interactions/{interactionId}/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pokulabs.com/interactions/{interactionId}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pokulabs.com/interactions/{interactionId}/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pokulabs.com/interactions/{interactionId}/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pokulabs.com/interactions/{interactionId}/status")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pokulabs.com/interactions/{interactionId}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"interactionId": "f3f7870f-30f5-4bf2-83b0-a05bc140030c",
"status": "pending",
"createdAt": "2026-04-28T22:30:00.000Z"
}Authorizations
Authentication header containing your Poku API key. Find it in the Poku dashboard. The format is "Bearer YOUR_API_KEY"
Path Parameters
The interaction ID returned by a Poku API request.
Response
Interaction status returned successfully.
Unique identifier for the interaction.
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 When the interaction was created.
Present when the interaction completed with a response. The shape matches the corresponding webhook event payload.
- Option 1
- Option 2
- Option 3
Show child attributes
Show child attributes