Spaces
Get Tasks by Space Token
Retrieve all tasks within a specific space using its token
GET
/
api
/
v2
/
platform
/
spaces
/
{space_token}
/
tasks
/
Get Tasks by Space Token
curl --request GET \
--url https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/ \
--header 'Authorization: <api-key>' \
--header 'Org-Handle: <org-handle>'import requests
url = "https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/"
headers = {
"Org-Handle": "<org-handle>",
"Authorization": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Org-Handle': '<org-handle>', Authorization: '<api-key>'}
};
fetch('https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/', 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://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/",
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: <api-key>",
"Org-Handle: <org-handle>"
],
]);
$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://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Org-Handle", "<org-handle>")
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/")
.header("Org-Handle", "<org-handle>")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"count": 1,
"status_code": 200,
"message": "Tasks Fetched Successfully",
"data": [
{
"_id": "697debb84c27faa892bfa0cd",
"space_id": "42",
"thread_id": "",
"user": "",
"user_org_id": "101",
"user_info": {},
"created": "2026-02-07T05:51:51.607000",
"modified": "2026-02-07T06:06:30.000000",
"task_id": "T1a2b3c4dfe9a11f0878d43cd8a99e069",
"run_id": "R1a2b3c4cfe9a11f0878d43cd8a99e069",
"collection_ref": "collection_data_SPTKN4XQ7M2VB9YH3KD8WZ1L",
"task": {},
"input": {
"contact_number": "+911234567890",
"quality": "good",
"name": "Jane Doe",
"token": "SPTKN4XQ7M2VB9YH3KD8WZ1L",
"space_token": "SPTKN4XQ7M2VB9YH3KD8WZ1L",
"org_id": 101,
"missing_space_context": false
},
"output": {
"call_id": "Unpod Bridge_1234567890_AbCdEfGhIjKl",
"customer": "Jane Doe",
"contact_number": "+911234567890",
"call_type": "inbound",
"call_status": "connected",
"call_end_reason": "USER_HUNG_UP_IN_CALL",
"transcript": [
{
"role": "assistant",
"content": "Hello, main Sunrise Heights se bol rahi hoon. Kya abhi baat karne ka sahi samay hai?",
"timestamp": "2026-02-07 05:58:00.000000",
"participant": "agent",
"start_time": "2026-02-07T05:57:55.000000",
"end_time": "2026-02-07T05:58:00.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, boliye.",
"timestamp": "2026-02-07 05:58:05.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:03.000000",
"end_time": "2026-02-07T05:58:05.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Thank you! Yeh call aapke Sunrise Heights me dikhaye gaye interest ke regarding hai. Kya main continue karoon?",
"timestamp": "2026-02-07 05:58:15.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:08.000000",
"end_time": "2026-02-07T05:58:15.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, main 2 BHK ke baare me dekh rahi thi.",
"timestamp": "2026-02-07 05:58:22.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:19.000000",
"end_time": "2026-02-07T05:58:22.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Bilkul. Hamare paas spacious 2 BHK residences hain, zero-wastage layouts ke saath. Kya main aapki site visit schedule kar doon?",
"timestamp": "2026-02-07 05:58:40.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:25.000000",
"end_time": "2026-02-07T05:58:40.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, kal 11 baje ke liye schedule kar dijiye.",
"timestamp": "2026-02-07 05:58:48.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:45.000000",
"end_time": "2026-02-07T05:58:48.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Perfect. Maine aapki visit kal 11 AM ke liye schedule kar di hai. Hamare sales expert aapko assist karenge. Dhanyavaad!",
"timestamp": "2026-02-07 05:59:05.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:52.000000",
"end_time": "2026-02-07T05:59:05.000000",
"language": "hi"
}
],
"recording_url": "https://cdn.unpod.ai/recordings/CALL_AbCdEfGhIjKl.mp3",
"files": [],
"start_time": "2026-02-07T05:57:45",
"end_time": "2026-02-07T06:06:25",
"call_timings": {
"call_dialed_at": "2026-02-07T05:57:44",
"call_connected_at": "2026-02-07T05:57:45",
"call_ended_at": "2026-02-07T06:06:25",
"ring_duration": 1,
"talk_duration": 520
},
"duration": 520,
"provider_call_id": "AbCdEfGhIjKlMnOpQrStUv@unpod.ai",
"assistant_number": "+919876543210",
"metadata": {
"cost": 0.600075,
"type": "",
"usage": {
"llm_provider": "Unpod",
"llm_model": "google/gemma-4-31b-it",
"tts_provider": "elevenlabs",
"tts_model": "eleven_v3",
"stt_provider": "soniox",
"stt_model": "stt-rt-v5",
"llm_prompt_tokens": 1199715,
"llm_completion_tokens": 1112,
"tts_characters_count": 4635,
"stt_audio_duration": 508.2,
"costs": {
"llm_cost": 0,
"stt_cost": 0.018,
"tts_cost": 0.4635
},
"total_cost": 0.5715
},
"provider": "livekit",
"room_name": "Unpod Bridge_1234567890_AbCdEfGhIjKl"
},
"post_call_data": {
"schema_version": 2,
"analytics": {
"sentiment": "positive",
"engagement": "high",
"tone": "friendly",
"contact_status": "active",
"call_score": 70,
"call_score_breakdown": {
"components": {
"interest_intent": 20,
"use_case_relevance": 10,
"timeline_urgency": 10,
"authority_influence": 10,
"engagement_quality": 10,
"next_step_commitment": 10
},
"total": 70,
"reason": "The user was actively engaged, showed strong interest in the offering, and agreed to a site visit."
}
},
"summary": {
"headline": "Site visit scheduled for tomorrow at 11 AM to explore the 2 BHK configuration.",
"key_points": [
"Customer showed interest in a 2 BHK residence.",
"Agent provided details about the residential project and its features.",
"Customer scheduled a site visit for tomorrow at 11:00 AM.",
"Agent confirmed the visit details and assured assistance during the visit."
]
},
"lead": {
"name": "Jane Doe",
"labels": [
"Interested"
],
"objections": [],
"pain_points": [],
"questions_asked": [
"What kind of space are you picturing for your family?",
"Can you repeat that once?",
"What are the available configurations?"
]
},
"structured_data": {
"status": "Qualified",
"outcome": "Call Disconnected",
"lead_intent": "High",
"end_call_reason": "Call Disconnected"
},
"next_action": {
"label": [
"Agent to schedule site visit for tomorrow at 11 AM",
"Agent to send visit details via WhatsApp and SMS"
],
"callback_requested": false,
"scheduled_at": null
},
"follow_up": {
"required": false,
"state": "skipped_inbound_call",
"reason": "Outcome falls under stop list conditions. No follow-up required.",
"next_at": null,
"attempt": 1,
"attempts_remaining": 1,
"policy": {
"max_call_attempts": 2,
"max_followup_attempts": 1,
"daily_limit": 3,
"next_call_attempt_number": null
}
},
"success_evaluation": {
"status": "completed",
"reason": "",
"result": 8
},
"call_evaluation": null,
"redial": {
"status": null
},
"skipped": [
{
"stage": "call_evaluation",
"reason": "policy:disabled_in_config"
},
{
"stage": "realtime_agent_evaluation",
"reason": "policy:disabled_in_config"
},
{
"stage": "spam_detection",
"reason": "policy:disabled_in_config"
}
]
},
"call_traces": [
{
"status": "callRequested",
"timestamp": "2026-02-07T05:57:44.000000",
"previous_status": "",
"message": "call status set: callRequested",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "ringing",
"timestamp": "2026-02-07T05:57:45.000000",
"previous_status": "callRequested",
"message": "call status changed: callRequested -> ringing",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "active",
"timestamp": "2026-02-07T05:57:46.000000",
"previous_status": "ringing",
"message": "call status changed: ringing -> active",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "hungUp",
"timestamp": "2026-02-07T06:06:24.000000",
"previous_status": "active",
"message": "call status changed: active -> hungUp | reason: USER_HUNG_UP_IN_CALL",
"event": "status_change",
"end_reason": "USER_HUNG_UP_IN_CALL",
"error_message": ""
},
{
"status": "connected",
"timestamp": "2026-02-07T06:06:29.000000",
"previous_status": "callEnded",
"message": "call finalized: connected",
"event": "finalized",
"end_reason": "USER_HUNG_UP_IN_CALL",
"error_message": ""
}
],
"error": "",
"error_code": "",
"end_reason": "User"
},
"attachments": [],
"assignee": "space-agent-8qmk42nslp91wrh3dz7btxc4",
"status": "completed",
"execution_type": "call",
"ref_id": "6902fb5840a736e125e80ebc",
"failure_count": 0,
"last_failure_reason": null,
"provider": null,
"retry_attempt": 0,
"referenced_task": null,
"follow_up_count": null,
"follow_up_chain_id": null,
"last_status_change": "2026-02-07T05:51:51.606885",
"scheduled_timestamp": null
}
]
}
{
"message": "Error fetching tasks",
"errors": "Detailed error description"
}
{
"count": 1,
"status_code": 200,
"message": "Tasks Fetched Successfully",
"data": [
{
"_id": "697debb84c27faa892bfa0cd",
"space_id": "42",
"thread_id": "",
"user": "",
"user_org_id": "101",
"user_info": {},
"created": "2026-02-07T05:51:51.607000",
"modified": "2026-02-07T06:06:30.000000",
"task_id": "T1a2b3c4dfe9a11f0878d43cd8a99e069",
"run_id": "R1a2b3c4cfe9a11f0878d43cd8a99e069",
"collection_ref": "collection_data_SPTKN4XQ7M2VB9YH3KD8WZ1L",
"task": {},
"input": {
"contact_number": "+911234567890",
"quality": "good",
"name": "Jane Doe",
"token": "SPTKN4XQ7M2VB9YH3KD8WZ1L",
"space_token": "SPTKN4XQ7M2VB9YH3KD8WZ1L",
"org_id": 101,
"missing_space_context": false
},
"output": {
"call_id": "Unpod Bridge_1234567890_AbCdEfGhIjKl",
"customer": "Jane Doe",
"contact_number": "+911234567890",
"call_type": "inbound",
"call_status": "connected",
"call_end_reason": "USER_HUNG_UP_IN_CALL",
"transcript": [
{
"role": "assistant",
"content": "Hello, main Sunrise Heights se bol rahi hoon. Kya abhi baat karne ka sahi samay hai?",
"timestamp": "2026-02-07 05:58:00.000000",
"participant": "agent",
"start_time": "2026-02-07T05:57:55.000000",
"end_time": "2026-02-07T05:58:00.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, boliye.",
"timestamp": "2026-02-07 05:58:05.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:03.000000",
"end_time": "2026-02-07T05:58:05.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Thank you! Yeh call aapke Sunrise Heights me dikhaye gaye interest ke regarding hai. Kya main continue karoon?",
"timestamp": "2026-02-07 05:58:15.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:08.000000",
"end_time": "2026-02-07T05:58:15.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, main 2 BHK ke baare me dekh rahi thi.",
"timestamp": "2026-02-07 05:58:22.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:19.000000",
"end_time": "2026-02-07T05:58:22.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Bilkul. Hamare paas spacious 2 BHK residences hain, zero-wastage layouts ke saath. Kya main aapki site visit schedule kar doon?",
"timestamp": "2026-02-07 05:58:40.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:25.000000",
"end_time": "2026-02-07T05:58:40.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, kal 11 baje ke liye schedule kar dijiye.",
"timestamp": "2026-02-07 05:58:48.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:45.000000",
"end_time": "2026-02-07T05:58:48.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Perfect. Maine aapki visit kal 11 AM ke liye schedule kar di hai. Hamare sales expert aapko assist karenge. Dhanyavaad!",
"timestamp": "2026-02-07 05:59:05.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:52.000000",
"end_time": "2026-02-07T05:59:05.000000",
"language": "hi"
}
],
"recording_url": "https://cdn.unpod.ai/recordings/CALL_AbCdEfGhIjKl.mp3",
"files": [],
"start_time": "2026-02-07T05:57:45",
"end_time": "2026-02-07T06:06:25",
"call_timings": {
"call_dialed_at": "2026-02-07T05:57:44",
"call_connected_at": "2026-02-07T05:57:45",
"call_ended_at": "2026-02-07T06:06:25",
"ring_duration": 1,
"talk_duration": 520
},
"duration": 520,
"provider_call_id": "AbCdEfGhIjKlMnOpQrStUv@unpod.ai",
"assistant_number": "+919876543210",
"metadata": {
"cost": 0.600075,
"type": "",
"usage": {
"llm_provider": "Unpod",
"llm_model": "google/gemma-4-31b-it",
"tts_provider": "elevenlabs",
"tts_model": "eleven_v3",
"stt_provider": "soniox",
"stt_model": "stt-rt-v5",
"llm_prompt_tokens": 1199715,
"llm_completion_tokens": 1112,
"tts_characters_count": 4635,
"stt_audio_duration": 508.2,
"costs": {
"llm_cost": 0,
"stt_cost": 0.018,
"tts_cost": 0.4635
},
"total_cost": 0.5715
},
"provider": "livekit",
"room_name": "Unpod Bridge_1234567890_AbCdEfGhIjKl"
},
"post_call_data": {
"schema_version": 2,
"analytics": {
"sentiment": "positive",
"engagement": "high",
"tone": "friendly",
"contact_status": "active",
"call_score": 70,
"call_score_breakdown": {
"components": {
"interest_intent": 20,
"use_case_relevance": 10,
"timeline_urgency": 10,
"authority_influence": 10,
"engagement_quality": 10,
"next_step_commitment": 10
},
"total": 70,
"reason": "The user was actively engaged, showed strong interest in the offering, and agreed to a site visit."
}
},
"summary": {
"headline": "Site visit scheduled for tomorrow at 11 AM to explore the 2 BHK configuration.",
"key_points": [
"Customer showed interest in a 2 BHK residence.",
"Agent provided details about the residential project and its features.",
"Customer scheduled a site visit for tomorrow at 11:00 AM.",
"Agent confirmed the visit details and assured assistance during the visit."
]
},
"lead": {
"name": "Jane Doe",
"labels": [
"Interested"
],
"objections": [],
"pain_points": [],
"questions_asked": [
"What kind of space are you picturing for your family?",
"Can you repeat that once?",
"What are the available configurations?"
]
},
"structured_data": {
"status": "Qualified",
"outcome": "Call Disconnected",
"lead_intent": "High",
"end_call_reason": "Call Disconnected"
},
"next_action": {
"label": [
"Agent to schedule site visit for tomorrow at 11 AM",
"Agent to send visit details via WhatsApp and SMS"
],
"callback_requested": false,
"scheduled_at": null
},
"follow_up": {
"required": false,
"state": "skipped_inbound_call",
"reason": "Outcome falls under stop list conditions. No follow-up required.",
"next_at": null,
"attempt": 1,
"attempts_remaining": 1,
"policy": {
"max_call_attempts": 2,
"max_followup_attempts": 1,
"daily_limit": 3,
"next_call_attempt_number": null
}
},
"success_evaluation": {
"status": "completed",
"reason": "",
"result": 8
},
"call_evaluation": null,
"redial": {
"status": null
},
"skipped": [
{
"stage": "call_evaluation",
"reason": "policy:disabled_in_config"
},
{
"stage": "realtime_agent_evaluation",
"reason": "policy:disabled_in_config"
},
{
"stage": "spam_detection",
"reason": "policy:disabled_in_config"
}
]
},
"call_traces": [
{
"status": "callRequested",
"timestamp": "2026-02-07T05:57:44.000000",
"previous_status": "",
"message": "call status set: callRequested",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "ringing",
"timestamp": "2026-02-07T05:57:45.000000",
"previous_status": "callRequested",
"message": "call status changed: callRequested -> ringing",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "active",
"timestamp": "2026-02-07T05:57:46.000000",
"previous_status": "ringing",
"message": "call status changed: ringing -> active",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "hungUp",
"timestamp": "2026-02-07T06:06:24.000000",
"previous_status": "active",
"message": "call status changed: active -> hungUp | reason: USER_HUNG_UP_IN_CALL",
"event": "status_change",
"end_reason": "USER_HUNG_UP_IN_CALL",
"error_message": ""
},
{
"status": "connected",
"timestamp": "2026-02-07T06:06:29.000000",
"previous_status": "callEnded",
"message": "call finalized: connected",
"event": "finalized",
"end_reason": "USER_HUNG_UP_IN_CALL",
"error_message": ""
}
],
"error": "",
"error_code": "",
"end_reason": "User"
},
"attachments": [],
"assignee": "space-agent-8qmk42nslp91wrh3dz7btxc4",
"status": "completed",
"execution_type": "call",
"ref_id": "6902fb5840a736e125e80ebc",
"failure_count": 0,
"last_failure_reason": null,
"provider": null,
"retry_attempt": 0,
"referenced_task": null,
"follow_up_count": null,
"follow_up_chain_id": null,
"last_status_change": "2026-02-07T05:51:51.606885",
"scheduled_timestamp": null
}
]
}
{
"message": "Error fetching tasks",
"errors": "Detailed error description"
}
Get Tasks by Space Token
Fetch all tasks for a specific space using the space token. Supports pagination withpage and page_size query parameters for efficient data retrieval.
Prerequisites: Make sure you have your API Token ready. See Authentication for details.
Get Tasks by Space Token
Retrieve all tasks associated with a specific space, with optional pagination.GET /api/v2/platform/spaces/{space_token}/tasks/
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| space_token | string | Yes | Public token identifying the workspace |
You can get the
space_token by hitting the Get All Spaces API. The token field in the response is your Space Token.Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Page number for pagination (default = 1) |
| page_size | integer | No | Number of tasks per page (default = 20) |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | API Key format: Token <token> |
| Content-Type | string | Yes | application/json |
Response Fields
| Field | Type | Description |
|---|---|---|
| count | integer | Total number of tasks |
| status_code | integer | HTTP status code |
| message | string | Response message |
| data | array | Array of task objects |
Task Object Fields
| Field | Type | Description |
|---|---|---|
| _id | string | Internal task document ID |
| thread_id | string | Thread identifier |
| user_info | object | User details (email, full_name) |
| task_id | string | Unique task identifier |
| run_id | string | Parent run identifier |
| task | object | Task definition with objective |
| input | object | Input data for the task |
| output | object | Task output with call details |
| assignee | string | Agent handle assigned to the task |
| status | string | Task status: pending, completed, failed |
| execution_type | string | Type of execution: call, email, etc. |
| run_mode | string | Execution mode: dev, prod, etc. |
| created | string | Task creation timestamp |
| modified | string | Last modified timestamp |
Common Error Codes
| Status Code | Description |
|---|---|
| 200 | Success - Data fetched successfully |
| 206 | Partial Content - Business logic error occurred |
| 400 | Bad Request - Invalid parameters provided |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Access denied to the resource |
| 404 | Not Found - Space not found |
| 500 | Internal Server Error - Server-side error |
Code Examples
const axios = require('axios');
const headers = {
'Authorization': 'Token your-api-token',
'Content-Type': 'application/json'
};
// Get tasks by space token with pagination
const getTasksBySpace = async (spaceToken, page = 1, pageSize = 20) => {
const response = await axios.get(
`https://unpod.ai/api/v2/platform/spaces/${spaceToken}/tasks/`,
{
headers,
params: { page, page_size: pageSize }
}
);
console.log(`Total tasks: ${response.data.count}`);
response.data.data.forEach(task => {
console.log(`Task ${task.task_id}: ${task.status}`);
});
return response.data.data;
};
// Example usage
getTasksBySpace('your-space-token', 1, 20);
import requests
headers = {
'Authorization': 'Token your-api-token',
'Content-Type': 'application/json'
}
def get_tasks_by_space(space_token: str, page: int = 1, page_size: int = 20):
"""Get tasks by space token with pagination"""
url = f'https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/'
params = {'page': page, 'page_size': page_size}
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f"Total tasks: {data['count']}")
for task in data['data']:
print(f"Task {task['task_id']}: {task['status']}")
return data['data']
# Example usage
get_tasks_by_space('your-space-token', page=1, page_size=20)
# Get tasks by space token with pagination
curl -X GET "https://unpod.ai/api/v2/platform/spaces/your-space-token/tasks/?page=1&page_size=20" \
-H "Authorization: Token your-api-token" \
-H "Content-Type: application/json"
Best Practices
- Pagination: Use
pageandpage_sizeparameters for efficient data retrieval in large datasets - Space Token: Ensure you are using a valid space token from your organization
- Error Handling: Always handle potential errors and edge cases
- Status Filtering: Filter tasks by status in your application logic to focus on relevant tasks
- Security: Keep API tokens secure and rotate them regularly
Authorizations
Format: Token
Headers
Organization domain handle
Example:
"unpod.tv"
Path Parameters
Example:
"8KZAMRAHSXXXXXXMAYNASMJC"
Response
List of tasks in the space
Was this page helpful?
⌘I
Get Tasks by Space Token
curl --request GET \
--url https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/ \
--header 'Authorization: <api-key>' \
--header 'Org-Handle: <org-handle>'import requests
url = "https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/"
headers = {
"Org-Handle": "<org-handle>",
"Authorization": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Org-Handle': '<org-handle>', Authorization: '<api-key>'}
};
fetch('https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/', 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://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/",
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: <api-key>",
"Org-Handle: <org-handle>"
],
]);
$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://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Org-Handle", "<org-handle>")
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/")
.header("Org-Handle", "<org-handle>")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://unpod.ai/api/v2/platform/spaces/{space_token}/tasks/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"count": 1,
"status_code": 200,
"message": "Tasks Fetched Successfully",
"data": [
{
"_id": "697debb84c27faa892bfa0cd",
"space_id": "42",
"thread_id": "",
"user": "",
"user_org_id": "101",
"user_info": {},
"created": "2026-02-07T05:51:51.607000",
"modified": "2026-02-07T06:06:30.000000",
"task_id": "T1a2b3c4dfe9a11f0878d43cd8a99e069",
"run_id": "R1a2b3c4cfe9a11f0878d43cd8a99e069",
"collection_ref": "collection_data_SPTKN4XQ7M2VB9YH3KD8WZ1L",
"task": {},
"input": {
"contact_number": "+911234567890",
"quality": "good",
"name": "Jane Doe",
"token": "SPTKN4XQ7M2VB9YH3KD8WZ1L",
"space_token": "SPTKN4XQ7M2VB9YH3KD8WZ1L",
"org_id": 101,
"missing_space_context": false
},
"output": {
"call_id": "Unpod Bridge_1234567890_AbCdEfGhIjKl",
"customer": "Jane Doe",
"contact_number": "+911234567890",
"call_type": "inbound",
"call_status": "connected",
"call_end_reason": "USER_HUNG_UP_IN_CALL",
"transcript": [
{
"role": "assistant",
"content": "Hello, main Sunrise Heights se bol rahi hoon. Kya abhi baat karne ka sahi samay hai?",
"timestamp": "2026-02-07 05:58:00.000000",
"participant": "agent",
"start_time": "2026-02-07T05:57:55.000000",
"end_time": "2026-02-07T05:58:00.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, boliye.",
"timestamp": "2026-02-07 05:58:05.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:03.000000",
"end_time": "2026-02-07T05:58:05.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Thank you! Yeh call aapke Sunrise Heights me dikhaye gaye interest ke regarding hai. Kya main continue karoon?",
"timestamp": "2026-02-07 05:58:15.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:08.000000",
"end_time": "2026-02-07T05:58:15.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, main 2 BHK ke baare me dekh rahi thi.",
"timestamp": "2026-02-07 05:58:22.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:19.000000",
"end_time": "2026-02-07T05:58:22.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Bilkul. Hamare paas spacious 2 BHK residences hain, zero-wastage layouts ke saath. Kya main aapki site visit schedule kar doon?",
"timestamp": "2026-02-07 05:58:40.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:25.000000",
"end_time": "2026-02-07T05:58:40.000000",
"language": "hi"
},
{
"role": "user",
"content": "Haan, kal 11 baje ke liye schedule kar dijiye.",
"timestamp": "2026-02-07 05:58:48.000000",
"participant": "sip_1234567890",
"start_time": "2026-02-07T05:58:45.000000",
"end_time": "2026-02-07T05:58:48.000000",
"language": "hi"
},
{
"role": "assistant",
"content": "Perfect. Maine aapki visit kal 11 AM ke liye schedule kar di hai. Hamare sales expert aapko assist karenge. Dhanyavaad!",
"timestamp": "2026-02-07 05:59:05.000000",
"participant": "agent",
"start_time": "2026-02-07T05:58:52.000000",
"end_time": "2026-02-07T05:59:05.000000",
"language": "hi"
}
],
"recording_url": "https://cdn.unpod.ai/recordings/CALL_AbCdEfGhIjKl.mp3",
"files": [],
"start_time": "2026-02-07T05:57:45",
"end_time": "2026-02-07T06:06:25",
"call_timings": {
"call_dialed_at": "2026-02-07T05:57:44",
"call_connected_at": "2026-02-07T05:57:45",
"call_ended_at": "2026-02-07T06:06:25",
"ring_duration": 1,
"talk_duration": 520
},
"duration": 520,
"provider_call_id": "AbCdEfGhIjKlMnOpQrStUv@unpod.ai",
"assistant_number": "+919876543210",
"metadata": {
"cost": 0.600075,
"type": "",
"usage": {
"llm_provider": "Unpod",
"llm_model": "google/gemma-4-31b-it",
"tts_provider": "elevenlabs",
"tts_model": "eleven_v3",
"stt_provider": "soniox",
"stt_model": "stt-rt-v5",
"llm_prompt_tokens": 1199715,
"llm_completion_tokens": 1112,
"tts_characters_count": 4635,
"stt_audio_duration": 508.2,
"costs": {
"llm_cost": 0,
"stt_cost": 0.018,
"tts_cost": 0.4635
},
"total_cost": 0.5715
},
"provider": "livekit",
"room_name": "Unpod Bridge_1234567890_AbCdEfGhIjKl"
},
"post_call_data": {
"schema_version": 2,
"analytics": {
"sentiment": "positive",
"engagement": "high",
"tone": "friendly",
"contact_status": "active",
"call_score": 70,
"call_score_breakdown": {
"components": {
"interest_intent": 20,
"use_case_relevance": 10,
"timeline_urgency": 10,
"authority_influence": 10,
"engagement_quality": 10,
"next_step_commitment": 10
},
"total": 70,
"reason": "The user was actively engaged, showed strong interest in the offering, and agreed to a site visit."
}
},
"summary": {
"headline": "Site visit scheduled for tomorrow at 11 AM to explore the 2 BHK configuration.",
"key_points": [
"Customer showed interest in a 2 BHK residence.",
"Agent provided details about the residential project and its features.",
"Customer scheduled a site visit for tomorrow at 11:00 AM.",
"Agent confirmed the visit details and assured assistance during the visit."
]
},
"lead": {
"name": "Jane Doe",
"labels": [
"Interested"
],
"objections": [],
"pain_points": [],
"questions_asked": [
"What kind of space are you picturing for your family?",
"Can you repeat that once?",
"What are the available configurations?"
]
},
"structured_data": {
"status": "Qualified",
"outcome": "Call Disconnected",
"lead_intent": "High",
"end_call_reason": "Call Disconnected"
},
"next_action": {
"label": [
"Agent to schedule site visit for tomorrow at 11 AM",
"Agent to send visit details via WhatsApp and SMS"
],
"callback_requested": false,
"scheduled_at": null
},
"follow_up": {
"required": false,
"state": "skipped_inbound_call",
"reason": "Outcome falls under stop list conditions. No follow-up required.",
"next_at": null,
"attempt": 1,
"attempts_remaining": 1,
"policy": {
"max_call_attempts": 2,
"max_followup_attempts": 1,
"daily_limit": 3,
"next_call_attempt_number": null
}
},
"success_evaluation": {
"status": "completed",
"reason": "",
"result": 8
},
"call_evaluation": null,
"redial": {
"status": null
},
"skipped": [
{
"stage": "call_evaluation",
"reason": "policy:disabled_in_config"
},
{
"stage": "realtime_agent_evaluation",
"reason": "policy:disabled_in_config"
},
{
"stage": "spam_detection",
"reason": "policy:disabled_in_config"
}
]
},
"call_traces": [
{
"status": "callRequested",
"timestamp": "2026-02-07T05:57:44.000000",
"previous_status": "",
"message": "call status set: callRequested",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "ringing",
"timestamp": "2026-02-07T05:57:45.000000",
"previous_status": "callRequested",
"message": "call status changed: callRequested -> ringing",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "active",
"timestamp": "2026-02-07T05:57:46.000000",
"previous_status": "ringing",
"message": "call status changed: ringing -> active",
"event": "status_change",
"end_reason": "",
"error_message": ""
},
{
"status": "hungUp",
"timestamp": "2026-02-07T06:06:24.000000",
"previous_status": "active",
"message": "call status changed: active -> hungUp | reason: USER_HUNG_UP_IN_CALL",
"event": "status_change",
"end_reason": "USER_HUNG_UP_IN_CALL",
"error_message": ""
},
{
"status": "connected",
"timestamp": "2026-02-07T06:06:29.000000",
"previous_status": "callEnded",
"message": "call finalized: connected",
"event": "finalized",
"end_reason": "USER_HUNG_UP_IN_CALL",
"error_message": ""
}
],
"error": "",
"error_code": "",
"end_reason": "User"
},
"attachments": [],
"assignee": "space-agent-8qmk42nslp91wrh3dz7btxc4",
"status": "completed",
"execution_type": "call",
"ref_id": "6902fb5840a736e125e80ebc",
"failure_count": 0,
"last_failure_reason": null,
"provider": null,
"retry_attempt": 0,
"referenced_task": null,
"follow_up_count": null,
"follow_up_chain_id": null,
"last_status_change": "2026-02-07T05:51:51.606885",
"scheduled_timestamp": null
}
]
}
{
"message": "Error fetching tasks",
"errors": "Detailed error description"
}