GET

api

platform

agents

{agent_handle}

executions

Get All Agent Executions

curl --request GET \
  --url https://unpod.ai/api/v2/platform/agents/{agent_handle}/executions/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'

import requests

url = "https://unpod.ai/api/v2/platform/agents/{agent_handle}/executions/"

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/agents/{agent_handle}/executions/', 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/agents/{agent_handle}/executions/",
  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/agents/{agent_handle}/executions/"

	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/agents/{agent_handle}/executions/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/agents/{agent_handle}/executions/")

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": 12,
  "status_code": 200,
  "message": "Executions fetched successfully",
  "data": [
    {
      "run_id": "Recac64fe03e911f1878d43cd8a99e069",
      "status": "completed",
      "total_tasks": 25,
      "completed_tasks": 23,
      "created": "2026-02-07T05:57:45Z"
    }
  ]
}

{
  "status_code": 404,
  "message": "Agent not found."
}

{
  "count": 12,
  "status_code": 200,
  "message": "Executions fetched successfully",
  "data": [
    {
      "run_id": "Recac64fe03e911f1878d43cd8a99e069",
      "status": "completed",
      "total_tasks": 25,
      "completed_tasks": 23,
      "created": "2026-02-07T05:57:45Z"
    }
  ]
}

{
  "status_code": 404,
  "message": "Agent not found."
}

Get All Agent Executions

Retrieve all execution runs associated with a specific agent. This endpoint provides a summary of each run including status, task counts, and timestamps - useful for monitoring agent performance and execution history.

Prerequisites: Make sure you have your API Token and Org-Handle ready. See Authentication for details.

Path Parameters

Name	Type	Required	Description
agent_handle	string	Yes	Unique handle/identifier of the agent

You can get the agent_handle by hitting the Get All Agents API. The handle field in the response is your Agent Handle.

Headers

Name	Type	Required	Description
Authorization	string	Yes	API Key format: `Token <token>`
Org-Handle	string	Yes	Organization domain handle

You can get the Org-Handle by hitting the Get All Organizations API. The domain_handle field in the response is your Org-Handle.

Response Fields

Field	Type	Description
count	integer	Total number of executions
status_code	integer	HTTP status code
message	string	Response message
data	array	Array of execution objects

Execution Object Fields

Field	Type	Description
run_id	string	Unique run identifier
status	string	Run status: `completed`, `running`, `failed`, `pending`
total_tasks	integer	Total number of tasks in the run
completed_tasks	integer	Number of successfully completed tasks
created	string	Run creation timestamp (ISO 8601)

Common Error Codes

Status Code	Description
200	Success - Request completed successfully
400	Bad Request - Invalid parameters provided
401	Unauthorized - Invalid or missing API token
403	Forbidden - Access denied to the resource
404	Not Found - Agent not found
500	Internal Server Error - Server-side error

Code Examples

const axios = require('axios');

const headers = {
  'Authorization': 'Token your-api-token',
  'Org-Handle': 'your-org-handle'
};

// Get all executions for an agent
const getAgentExecutions = async (agentHandle) => {
  const response = await axios.get(
    `https://unpod.ai/api/v2/platform/agents/${agentHandle}/executions/`,
    { headers }
  );
  console.log(`Total executions: ${response.data.count}`);
  response.data.data.forEach(exec => {
    const completionRate = (exec.completed_tasks / exec.total_tasks * 100).toFixed(1);
    console.log(`Run ${exec.run_id}: ${exec.status} (${completionRate}% complete)`);
  });
  return response.data.data;
};

// Example usage
getAgentExecutions('space-agent-8qmk42nslp91wrh3dz7btxc4');

import requests

headers = {
    'Authorization': 'Token your-api-token',
    'Org-Handle': 'your-org-handle'
}

def get_agent_executions(agent_handle: str):
    """Get all executions for a specific agent"""
    url = f'https://unpod.ai/api/v2/platform/agents/{agent_handle}/executions/'
    response = requests.get(url, headers=headers)
    data = response.json()
    print(f"Total executions: {data['count']}")
    for exec_item in data['data']:
        completion_rate = exec_item['completed_tasks'] / exec_item['total_tasks'] * 100
        print(f"Run {exec_item['run_id']}: {exec_item['status']} ({completion_rate:.1f}% complete)")
    return data['data']

# Example usage
get_agent_executions('space-agent-8qmk42nslp91wrh3dz7btxc4')

# Get all executions for an agent
curl -X GET "https://unpod.ai/api/v2/platform/agents/space-agent-8qmk42nslp91wrh3dz7btxc4/executions/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle"

Best Practices

Agent Handle: Use the exact agent handle from the Get All Agents response
Completion Tracking: Calculate completed_tasks / total_tasks ratio to monitor run success rates
Status Monitoring: Poll this endpoint to track long-running executions
Error Handling: Always handle potential errors and edge cases
Security: Keep API tokens secure and rotate them regularly

Authorizations

Authorization

string

header

required

Format: Token

Headers

Org-Handle

string

required

Organization domain handle

Example:

"unpod.tv"

Path Parameters

agent_handle

string

required

Example:

"space-agent-8qmk42nslp91wrh3dz7btxc4"

Response

List of executions for the agent

OverviewIntroduction to the Task - Make Call API

Get All Agent Executions

curl --request GET \
  --url https://unpod.ai/api/v2/platform/agents/{agent_handle}/executions/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'

import requests

url = "https://unpod.ai/api/v2/platform/agents/{agent_handle}/executions/"

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/agents/{agent_handle}/executions/', 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/agents/{agent_handle}/executions/",
  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/agents/{agent_handle}/executions/"

	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/agents/{agent_handle}/executions/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/agents/{agent_handle}/executions/")

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": 12,
  "status_code": 200,
  "message": "Executions fetched successfully",
  "data": [
    {
      "run_id": "Recac64fe03e911f1878d43cd8a99e069",
      "status": "completed",
      "total_tasks": 25,
      "completed_tasks": 23,
      "created": "2026-02-07T05:57:45Z"
    }
  ]
}

{
  "status_code": 404,
  "message": "Agent not found."
}

Getting Started

API Lists

Get All Agent Executions

Get All Agent Executions

Path Parameters

Headers

Response Fields

Execution Object Fields

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Path Parameters

Response

​Get All Agent Executions

​Path Parameters

​Headers

​Response Fields

​Execution Object Fields

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Path Parameters

Response

Get All Agent Executions

Path Parameters

Headers

Response Fields

Execution Object Fields

Common Error Codes

Code Examples

Best Practices