cURL
# Get all executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search" \
-H "x-api-key: $CATALOG_API_KEY"
# Get only completed executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search?status=completed" \
-H "x-api-key: $CATALOG_API_KEY"
# Get first 50 executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search?page_size=50" \
-H "x-api-key: $CATALOG_API_KEY"
// Get all executions
const response = await fetch('https://api.getcatalog.ai/v2/agentic-search', {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} executions`);
import requests
# Get all executions
response = requests.get(
'https://api.getcatalog.ai/v2/agentic-search',
headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()
print(f"Found {len(data['data'])} executions")
{
"data": [
{
"execution_id": "agentic-a1b2c3d4-1735123456789",
"status": "completed",
"created_at": "2025-01-15T10:30:00.000Z"
},
{
"execution_id": "agentic-e5f6g7h8-1735127000000",
"status": "processing",
"created_at": "2025-01-15T11:00:00.000Z"
},
{
"execution_id": "agentic-i9j0k1l2-1735120000000",
"status": "failed",
"created_at": "2025-01-15T09:15:00.000Z"
}
],
"pagination": {
"page": 1,
"page_size": 20,
"total_items": 3,
"total_pages": 1,
"has_next": false,
"has_prev": false
},
"meta": {}
}
Search
List Agentic Searches
List all agentic searches with status. Shows all search jobs, their current status, and when they were created.
GET
/
v2
/
agentic-search
cURL
# Get all executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search" \
-H "x-api-key: $CATALOG_API_KEY"
# Get only completed executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search?status=completed" \
-H "x-api-key: $CATALOG_API_KEY"
# Get first 50 executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search?page_size=50" \
-H "x-api-key: $CATALOG_API_KEY"
// Get all executions
const response = await fetch('https://api.getcatalog.ai/v2/agentic-search', {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} executions`);
import requests
# Get all executions
response = requests.get(
'https://api.getcatalog.ai/v2/agentic-search',
headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()
print(f"Found {len(data['data'])} executions")
{
"data": [
{
"execution_id": "agentic-a1b2c3d4-1735123456789",
"status": "completed",
"created_at": "2025-01-15T10:30:00.000Z"
},
{
"execution_id": "agentic-e5f6g7h8-1735127000000",
"status": "processing",
"created_at": "2025-01-15T11:00:00.000Z"
},
{
"execution_id": "agentic-i9j0k1l2-1735120000000",
"status": "failed",
"created_at": "2025-01-15T09:15:00.000Z"
}
],
"pagination": {
"page": 1,
"page_size": 20,
"total_items": 3,
"total_pages": 1,
"has_next": false,
"has_prev": false
},
"meta": {}
}
When to use: Monitor all your agentic search operations in one place. Use this endpoint to:
- See all search executions you’ve started
- Filter by status (processing, completed, failed)
- Track when searches were initiated
- Find execution IDs for status checks
Request
string
required
Your API key for authentication
Query Parameters
string
Filter executions by status. Possible values:
"processing", "completed", "failed"Note: If not provided, all executions are returned regardless of status.number
Number of executions to return per page (default: 20)Note: Executions are returned in reverse chronological order (most recent first).
Response
array
Array of execution summary objects
Show Execution Summary
Show Execution Summary
string
Unique execution identifier. Use this ID with
GET /v2/agentic-search/{execution_id} to check detailed status and results.Format: agentic-{uuid}-{timestamp}string
Current execution statusPossible values:
"processing"- Execution is currently running"completed"- Execution finished successfully"failed"- Execution failed or was aborted
string
ISO 8601 timestamp when the execution was created
object
Pagination information for the response
Show Pagination Object
Show Pagination Object
number
Current page number (always 1 for this endpoint)
number
Number of items per page
number
Total number of executions returned (may be less than or equal to page_size)
number
Total number of pages (always 1 for this endpoint)
boolean
Whether there are more pages available (always false for this endpoint)
boolean
Whether there are previous pages available (always false for this endpoint)
object
Metadata object (currently empty for this endpoint)
cURL
# Get all executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search" \
-H "x-api-key: $CATALOG_API_KEY"
# Get only completed executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search?status=completed" \
-H "x-api-key: $CATALOG_API_KEY"
# Get first 50 executions
curl -X GET "https://api.getcatalog.ai/v2/agentic-search?page_size=50" \
-H "x-api-key: $CATALOG_API_KEY"
// Get all executions
const response = await fetch('https://api.getcatalog.ai/v2/agentic-search', {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} executions`);
import requests
# Get all executions
response = requests.get(
'https://api.getcatalog.ai/v2/agentic-search',
headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()
print(f"Found {len(data['data'])} executions")
{
"data": [
{
"execution_id": "agentic-a1b2c3d4-1735123456789",
"status": "completed",
"created_at": "2025-01-15T10:30:00.000Z"
},
{
"execution_id": "agentic-e5f6g7h8-1735127000000",
"status": "processing",
"created_at": "2025-01-15T11:00:00.000Z"
},
{
"execution_id": "agentic-i9j0k1l2-1735120000000",
"status": "failed",
"created_at": "2025-01-15T09:15:00.000Z"
}
],
"pagination": {
"page": 1,
"page_size": 20,
"total_items": 3,
"total_pages": 1,
"has_next": false,
"has_prev": false
},
"meta": {}
}
⌘I