Skip to main content
GET
https://api.getcatalog.ai
/
v2
/
agentic-search
# 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"

{
  "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

​
x-api-key
string
required
Your API key for authentication

​
Query Parameters

​
status
string
Filter executions by status. Possible values: "processing", "completed", "failed"Note: If not provided, all executions are returned regardless of status.
​
page_size
number
Number of executions to return per page (default: 20)Note: Executions are returned in reverse chronological order (most recent first).

​
Response

​
data
array
Array of execution summary objects
​
pagination
object
Pagination information for the response
​
meta
object
Metadata object (currently empty for this endpoint)
# 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"

{
  "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": {}
}