cURL
# Get all executions
curl -X GET "https://api.getcatalog.ai/v1/products" \
-H "x-api-key: $CATALOG_API_KEY"
# Get only completed executions
curl -X GET "https://api.getcatalog.ai/v1/products?status=completed" \
-H "x-api-key: $CATALOG_API_KEY"
// Get all executions
const response = await fetch('https://api.getcatalog.ai/v1/products', {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} executions`);
// Get only completed executions
const processingResponse = await fetch(
'https://api.getcatalog.ai/v1/products?status=completed',
{
headers: {
'x-api-key': 'YOUR_API_KEY'
}
}
);
const processingData = await processingResponse.json();
console.log(`Found ${processingData.data.length} processing executions`);
import requests
# Get all executions
response = requests.get(
'https://api.getcatalog.ai/v1/products',
headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()
print(f"Found {len(data['data'])} executions")
# Get only completed executions
failed_response = requests.get(
'https://api.getcatalog.ai/v1/products',
headers={'x-api-key': 'YOUR_API_KEY'},
params={'status': 'completed'}
)
failed_data = failed_response.json()
print(f"Found {len(failed_data['data'])} failed executions")
{
"executions": [
{
"execution_id": "products-batch-51d87084-7f42-402f-a5af-6ff512c82cd0",
"status": "completed",
"created_at": "2026-01-08T13:37:33.234859+00:00"
}
]
}
Extract
List Products
List all extracts with status. Shows all extract jobs, their current status, and when they were created.
GET
/
v1
/
products
cURL
# Get all executions
curl -X GET "https://api.getcatalog.ai/v1/products" \
-H "x-api-key: $CATALOG_API_KEY"
# Get only completed executions
curl -X GET "https://api.getcatalog.ai/v1/products?status=completed" \
-H "x-api-key: $CATALOG_API_KEY"
// Get all executions
const response = await fetch('https://api.getcatalog.ai/v1/products', {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} executions`);
// Get only completed executions
const processingResponse = await fetch(
'https://api.getcatalog.ai/v1/products?status=completed',
{
headers: {
'x-api-key': 'YOUR_API_KEY'
}
}
);
const processingData = await processingResponse.json();
console.log(`Found ${processingData.data.length} processing executions`);
import requests
# Get all executions
response = requests.get(
'https://api.getcatalog.ai/v1/products',
headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()
print(f"Found {len(data['data'])} executions")
# Get only completed executions
failed_response = requests.get(
'https://api.getcatalog.ai/v1/products',
headers={'x-api-key': 'YOUR_API_KEY'},
params={'status': 'completed'}
)
failed_data = failed_response.json()
print(f"Found {len(failed_data['data'])} failed executions")
{
"executions": [
{
"execution_id": "products-batch-51d87084-7f42-402f-a5af-6ff512c82cd0",
"status": "completed",
"created_at": "2026-01-08T13:37:33.234859+00:00"
}
]
}
When to use: Monitor all your product processing operations in one place. Use this endpoint to:
- See all product processing executions you’ve started
- Filter by status (processing, completed, failed)
- Track when processing jobs were initiated
- Find execution IDs for status checks
Organization Scoped: This endpoint only returns executions belonging to your organization. You cannot see executions from other organizations.
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 (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 /v1/products/{execution_id} to check detailed status and results.Format: products-batch-{uuid}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
cURL
# Get all executions
curl -X GET "https://api.getcatalog.ai/v1/products" \
-H "x-api-key: $CATALOG_API_KEY"
# Get only completed executions
curl -X GET "https://api.getcatalog.ai/v1/products?status=completed" \
-H "x-api-key: $CATALOG_API_KEY"
// Get all executions
const response = await fetch('https://api.getcatalog.ai/v1/products', {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Found ${data.data.length} executions`);
// Get only completed executions
const processingResponse = await fetch(
'https://api.getcatalog.ai/v1/products?status=completed',
{
headers: {
'x-api-key': 'YOUR_API_KEY'
}
}
);
const processingData = await processingResponse.json();
console.log(`Found ${processingData.data.length} processing executions`);
import requests
# Get all executions
response = requests.get(
'https://api.getcatalog.ai/v1/products',
headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()
print(f"Found {len(data['data'])} executions")
# Get only completed executions
failed_response = requests.get(
'https://api.getcatalog.ai/v1/products',
headers={'x-api-key': 'YOUR_API_KEY'},
params={'status': 'completed'}
)
failed_data = failed_response.json()
print(f"Found {len(failed_data['data'])} failed executions")
{
"executions": [
{
"execution_id": "products-batch-51d87084-7f42-402f-a5af-6ff512c82cd0",
"status": "completed",
"created_at": "2026-01-08T13:37:33.234859+00:00"
}
]
}
⌘I