List Products

List all extracts with status. Shows all extract jobs, their current status, and when they were created.

GET /v1/products

cURL

PowerShell

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

Success Response

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

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 (default: 20)

Note: Executions are returned in reverse chronological order (most recent first).

Response

data · array

Array of execution summary objects

Show Execution Summary

execution_id · string

Unique execution identifier. Use this ID with GET /v1/products/{execution_id} to check detailed status and results.

Format: products-batch-{uuid}

status · string

Current execution status

Possible values:

• "processing" - Execution is currently running
• "completed" - Execution finished successfully
• "failed" - Execution failed or was aborted

created_at · string

ISO 8601 timestamp when the execution was created

pagination · object

Pagination metadata

Show Pagination Properties

page · number

Current page number

page_size · number

Number of items per page

total_items · number

Total number of items across all pages

total_pages · number

Total number of pages available

has_next · boolean

Whether there is a next page

has_prev · boolean

Whether there is a previous page

meta · object

Response metadata

Show Meta Properties

request_id · string

Unique request identifier for support purposes

cURL

PowerShell

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

Success Response

{
  "executions": [
    {
      "execution_id": "products-batch-51d87084-7f42-402f-a5af-6ff512c82cd0",
      "status": "completed",
      "created_at": "2026-01-08T13:37:33.234859+00:00"
    }
  ]
}