Get Agentic Search Status

Get agentic search status and results for an asynchronous search job.

GET https://api.getcatalog.ai/v2/agentic-search/{execution_id}

cURL

PowerShell

# Check execution status
curl -X GET "https://api.getcatalog.ai/v2/agentic-search/agentic-a1b2c3d4-1735123456789" \
  -H "x-api-key: $CATALOG_API_KEY"

Status: Completed

{
  "execution_id": "agentic-589b1966-1770040673820",
  "status": "completed",
  "error": null,
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": {
      "products_processed": 8,
      "products_total": 8,
      "percent_complete": 100
    },
    "start_date": "2026-02-02T13:57:54.099Z",
    "stop_date": "2026-02-02T14:03:41.281Z",
    "duration_ms": 347182,
    "result": {
      "products_returned": 8
    },
    "credits_used": 25
  },
  "data": [
    {
      "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
      "product": {
        "id": "8a19462a-1499-4221-9fff-fca3f036cc27",
        "title": "Cropped Beadnell Waxed Jacket",
        "description": "The Beadnell waxed jacket has been a part of Barbour's signature waxed jacket selection since 2010, offering a feminine, tailored rendition of the best-selling men's Bedale waxed jacket to the collection. This season, the Beadnell takes on a modern new look as the Barbour Cropped Beadnell Waxed Jacket displays oversized details featured on the original style. With large, gold-tone, branded snap buttons and the traditional saddle pockets, this style is complete with a cord collar and exaggerated elasticated cuffs for a contemporary touch.",
        "vendor": "barbour.com",
        "brand": "Barbour",
        "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
        "handle": "cropped-beadnell-waxed-jacket-lwx1403bk71",
        "is_available": true,
        "attributes": {
          "additional_attributes": [
            "cropped silhouette",
            "feminine, tailored rendition of the Bedale",
            "oversized details inspired by original style",
            "large gold-tone branded snap buttons",
            "traditional saddle pockets",
            "cord collar",
            "exaggerated elasticated cuffs",
            "waxed finish"
          ],
          "age_group": "adult",
          "gender": "female",
          "summary": "Cropped, feminine waxed jacket offering a tailored take on Barbour's Bedale with oversized details and contemporary finishes.",
          "features": "Cropped silhouette with oversized detailing; large gold-tone branded snap button closure; traditional saddle pockets; cord collar; exaggerated elasticated cuffs; waxed finish.",
          "care_instructions": "null",
          "color": {
            "iscc_family": "black",
            "merchant_label": "Black-Classic"
          },
          "closure_type": "snap",
          "style": [
            "tailored",
            "heritage",
            "modern"
          ],
          "mood": [
            "feminine"
          ],
          "additional_product_information": "The Beadnell waxed jacket is a feminine, tailored rendition of the classic Bedale waxed jacket. Key features: large gold-tone branded snap buttons, traditional saddle pockets, cord collar and exaggerated elasticated cuffs for a contemporary touch. Part of Barbour's signature waxed jacket selection since 2010. SKU: LWX1403BK71. Price: $425.00 (USD). Full-product images (multiple angles and detail shots) are provided on the product page."
        },
        "price": {
          "current_value": 425,
          "compare_at_value": 425,
          "currency": "USD"
        },
        "images": [
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image (primary)",
            "position": 1,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-0",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw3435dec4/images/LWX1403BK71/LWX1403BK71_03getthelook.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 2",
            "position": 2,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-1",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw433521eb/images/LWX1403BK71/LWX1403BK71_04back.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 3",
            "position": 3,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-2",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwb09d0c6f/images/LWX1403BK71/LWX1403BK71_05detaila.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 4",
            "position": 4,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-3",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwebbb5a93/images/LWX1403BK71/LWX1403BK71_05detailb.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 5",
            "position": 5,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-4",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw6cc4cf07/images/LWX1403BK71/LWX1403BK71_05detailc.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 6",
            "position": 6,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-5",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04f04054/images/LWX1403BK71/LWX1403BK71_05detaild.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 7",
            "position": 7,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-6",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          }
        ],
        "options": [
          {
            "name": "Color",
            "position": 1,
            "values": [
              "Black-Classic"
            ]
          },
          {
            "name": "Size",
            "position": 2,
            "values": [
              "US 2",
              "US 4",
              "US 6",
              "US 8",
              "US 10",
              "US 12",
              "US 14",
              "US 16"
            ]
          }
        ],
        "variants": [
          {
            "id": "variant-1770040913275-0",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 2",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 2",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 2 variant image",
              "position": 1,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-0",
              "variant_ids": [
                "variant-1770040913275-0"
              ]
            }
          },
          {
            "id": "variant-1770040913275-1",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 4",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 4",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 4 variant image",
              "position": 2,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-1",
              "variant_ids": [
                "variant-1770040913275-1"
              ]
            }
          },
          {
            "id": "variant-1770040913275-2",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 6",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 6",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 6 variant image",
              "position": 3,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-2",
              "variant_ids": [
                "variant-1770040913275-2"
              ]
            }
          },
          {
            "id": "variant-1770040913275-3",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 8",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 8",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 8 variant image",
              "position": 4,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-3",
              "variant_ids": [
                "variant-1770040913275-3"
              ]
            }
          },
          {
            "id": "variant-1770040913275-4",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 10",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 10",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 10 variant image",
              "position": 5,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-4",
              "variant_ids": [
                "variant-1770040913275-4"
              ]
            }
          },
          {
            "id": "variant-1770040913275-5",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 12",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 12",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 12 variant image",
              "position": 6,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-5",
              "variant_ids": [
                "variant-1770040913275-5"
              ]
            }
          },
          {
            "id": "variant-1770040913275-6",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 14",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 14",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 14 variant image",
              "position": 7,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-6",
              "variant_ids": [
                "variant-1770040913275-6"
              ]
            }
          },
          {
            "id": "variant-1770040913275-7",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 16",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 16",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 16 variant image",
              "position": 8,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-7",
              "variant_ids": [
                "variant-1770040913275-7"
              ]
            }
          }
        ],
        "store_canonical_url": "https://www.barbour.com/",
        "store_domain": "www.barbour.com",
        "platform": null,
        "platform_id": "LWX1403BK71",
        "description_html": "*content*"
        "product_type": "JACKETS",
        "google_product_category_id": "5598",
        "google_product_category_path": "Apparel & Accessories > Clothing > Outerwear > Coats & Jackets",
        "tags": [
          "JACKETS"
        ],
        "video_url": null,
        "review_count": null,
        "average_rating": null,
        "rating_scale": 5,
        "faqs": null,
        "reviews": null,
        "updated_at": "2026-02-02T14:02:32.789Z",
        "enable_enrichment": true,
        "enable_reviews": false,
        "enable_image_tags": false,
        "enable_full_html": false,
        "brand_pdp": null,
        "similar_products": null,
        "reddit_insights": null,
        "enable_brand_pdp": false,
        "enable_similar_products": false,
        "enable_reddit_insights": false
      }
    },
    ...
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_items": 8,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

When to use: After starting a search job with the POST endpoint, use this endpoint to:

• Check if the search is complete
• Monitor real-time progress
• Get detailed metrics including products found
• Retrieve paginated product results when processing completes
• Track execution timing and duration

Authentication Required: This endpoint requires a valid API key. Execution IDs are scoped to your organization - you can only access executions that belong to your organization.

Cancel Running Executions: If you need to stop a search that is currently running, use DELETE /v2/agentic-search/{execution_id} to stop the execution.

Request

x-api-key · string · required

Your API key for authentication

execution_id · string · required

The execution ID returned from POST /v2/agentic-search

Format: agentic-{uuid}-{timestamp}

Note: If the execution ID does not exist or does not belong to your organization, the endpoint returns a 404 Not Found error.

Query Parameters

page · number · default: "1"

Page number for paginated results (only applicable when status is “completed”)

Minimum: 1

page_size · number · default: "50"

Number of results per page (only applicable when status is “completed”)

Maximum: 100

Response

execution_id · string

The execution identifier

status · string

Current execution status

Possible values:

• "pending" - Execution has been created but not yet started
• "running" - Execution is currently processing
• "completed" - Execution finished successfully
• "failed" - Execution failed or was aborted

error · string | null

Error message if the execution failed, otherwise null

data · array

Array of product results (only present when status is “completed”, up to 8 items). Fewer items may be returned if some cannot be processed or don’t meet quality requirements.

Hide Product Result

url · string

Original URL that was processed

success · boolean

Whether the product was successfully processed

product · object | null

Product object

Hide Product Object

id · string

Unique product identifier

title · string

Product title

description · string

Detailed product description

vendor · string

Store/retailer (e.g. hostname such as “nike.com”)

brand · string | null

Product brand name

url · string

Product URL

handle · string | null

Product handle/slug

is_available · boolean

Product availability status

price · object | null

Object with price information.

Show Price object

current_value · number | null

Price value

compare_at_value · number | null

Compare-at / MSRP value

currency · string

Currency code (e.g. “USD”)

images · array

Array of image objects.

Show Image object

url · string

Image URL

alt_text · string | null

Alt text

attributes · object | null

Optional AI/image analysis: labels (string[]), text (string | null), colors (array of ), description (string), confidence (“low” | “medium” | “high”), flat_lay (boolean)

position · number

Display order (Shopify-style images only)

width · number

Width in pixels (Shopify-style images only)

height · number

Height in pixels (Shopify-style images only)

id · string

Image ID (Shopify-style images only)

variant_ids · array

Variant IDs linked to this image (Shopify-style images only)

options · array

Array of option objects.

Show Option object

name · string

Option name (e.g. “Size”, “Color”)

position · number

Display order

values · array

Option values (e.g. [“S”, “M”, “L”])

variants · array

Array of variant objects.

Show Variant object

id · string

Variant ID

title · string

Variant title

image · object | null

Optional image; same shape as Image object above

is_available · boolean | null

Availability

price · object

Price object (current_value, compare_at_value, currency)

is_shipping_required · boolean | null

Whether shipping is required

sku · string

SKU

is_taxable · boolean | null

Whether variant is taxable

weight · number | null

Weight

option1 · string | null

First option value (e.g. size)

option2 · string | null

Second option value (e.g. color)

option3 · string | null

Third option value

url · string | null

Variant URL

affiliate_link · string | null

Affiliate link URL

quantity_available · number | null

Quantity available (Shopify-style variants only)

store_canonical_url · string | null

Canonical store URL

store_domain · string

Store domain

platform · string | null

E-commerce platform (null if not identified)

platform_id · string | null

Platform-specific ID

description_html · string | null

HTML-formatted description

product_type · string | null

Product type/category

google_product_category_id · string | null

Google product category identifier

google_product_category_path · string | null

Full Google product category path

tags · array

Array of product tags (strings)

video_url · string | null

Product video URL (if available)

updated_at · string

Last update timestamp (ISO 8601)

attributes · object

Product attributes when AI enrichment is enabled.

Show Attributes object

Key-value object from AI enrichment. Structure is product-dependent; no fixed schema. May include semantic attributes (e.g. style, material, occasion) and other enriched fields.

review_count · number | null

Review count (when reviews enabled)

average_rating · number | null

Average rating (when reviews enabled)

rating_scale · number | null

Rating scale (e.g. 5)

faqs · array | null

Array of FAQ objects.

Show FAQ object

question · string

Question

answer · string

Answer

reviews · array | null

Array of review objects.

Show Review object

date · string | null

Review date

title · string | null

Review title

rating · number | string | null

Rating

content · string | null

Review body

image_url · string | null

Review image URL

reviewer_name · string | null

Reviewer name

brand_pdp · object | null

Brand PDP data when brand PDP discovery is enabled.

Show Brand PDP object

Present when brand PDP discovery is enabled.

success · boolean

Whether brand PDP was found

brand_pdp_url · string | null

Brand PDP URL

brand_domain · string | null

Brand domain

brand_name · string | null

Brand name

product_title · string | null

Product title used for matching

confidence · string | null

“high” | “medium” | “low”

error · string | null

Error message if success is false

similar_products · array | null

Similar products when similar products discovery is enabled.

Show Similar product object

title · string

Product title

url · string

Product URL

brand · string | null

Brand name

similarity · string

“high” | “medium” | “low”

reddit_insights · object | null

Reddit consumer voice when Reddit insights are enabled.

Show Reddit insights object

Present when Reddit insights are enabled. Nested structure from Reddit consumer voice.

status · string

“ok” | “error” | “no_results”

generated_at · string

ISO timestamp

match · object

confidence (number 0–1), matched_terms (string[]), notes (string)

coverage · object

threads_used (number), subreddits (string[])

conversation_summary · object

one_liner (string), sentiment (object), top_themes (array), use_cases (array), comparisons (array), common_questions (array), gotchas (array)

evidence · object

items (array of evidence items: ref_id, type, title, excerpt, author, subreddit, thread )

outcome · string

Machine-readable reason for failure (only present when success is false and a specific reason is available)

pagination · object

Pagination metadata for the results (only present when status is “completed” and data is returned)

Show Pagination Properties

page · number

Current page number

page_size · number

Number of items per page

total_items · number

Total number of products returned

total_pages · number

Total number of pages

has_next · boolean

Whether there is a next page

has_prev · boolean

Whether there is a previous page

meta · object

Detailed metadata about the execution

Show Meta Object

query · string

The search query used for this execution

progress · object | null

Real-time progress information (only available when status is “running”)

Show Progress Object

products_processed · number

Number of products processed so far

products_total · number

Total number of products to process (up to 8)

percent_complete · number

Percentage of completion (0-100)

start_date · string | null

ISO 8601 timestamp when the execution started

stop_date · string | null

ISO 8601 timestamp when the execution stopped (only available when completed or failed)

duration_ms · number | null

Duration of the execution in milliseconds (only available when execution has started)

result · object

Result statistics (only available when status is “completed”)

Show Result Object

products_returned · number

Number of products returned in the response

cURL

PowerShell

# Check execution status
curl -X GET "https://api.getcatalog.ai/v2/agentic-search/agentic-a1b2c3d4-1735123456789" \
  -H "x-api-key: $CATALOG_API_KEY"

Status: Completed

{
  "execution_id": "agentic-589b1966-1770040673820",
  "status": "completed",
  "error": null,
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": {
      "products_processed": 8,
      "products_total": 8,
      "percent_complete": 100
    },
    "start_date": "2026-02-02T13:57:54.099Z",
    "stop_date": "2026-02-02T14:03:41.281Z",
    "duration_ms": 347182,
    "result": {
      "products_returned": 8
    },
    "credits_used": 25
  },
  "data": [
    {
      "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
      "product": {
        "id": "8a19462a-1499-4221-9fff-fca3f036cc27",
        "title": "Cropped Beadnell Waxed Jacket",
        "description": "The Beadnell waxed jacket has been a part of Barbour's signature waxed jacket selection since 2010, offering a feminine, tailored rendition of the best-selling men's Bedale waxed jacket to the collection. This season, the Beadnell takes on a modern new look as the Barbour Cropped Beadnell Waxed Jacket displays oversized details featured on the original style. With large, gold-tone, branded snap buttons and the traditional saddle pockets, this style is complete with a cord collar and exaggerated elasticated cuffs for a contemporary touch.",
        "vendor": "barbour.com",
        "brand": "Barbour",
        "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
        "handle": "cropped-beadnell-waxed-jacket-lwx1403bk71",
        "is_available": true,
        "attributes": {
          "additional_attributes": [
            "cropped silhouette",
            "feminine, tailored rendition of the Bedale",
            "oversized details inspired by original style",
            "large gold-tone branded snap buttons",
            "traditional saddle pockets",
            "cord collar",
            "exaggerated elasticated cuffs",
            "waxed finish"
          ],
          "age_group": "adult",
          "gender": "female",
          "summary": "Cropped, feminine waxed jacket offering a tailored take on Barbour's Bedale with oversized details and contemporary finishes.",
          "features": "Cropped silhouette with oversized detailing; large gold-tone branded snap button closure; traditional saddle pockets; cord collar; exaggerated elasticated cuffs; waxed finish.",
          "care_instructions": "null",
          "color": {
            "iscc_family": "black",
            "merchant_label": "Black-Classic"
          },
          "closure_type": "snap",
          "style": [
            "tailored",
            "heritage",
            "modern"
          ],
          "mood": [
            "feminine"
          ],
          "additional_product_information": "The Beadnell waxed jacket is a feminine, tailored rendition of the classic Bedale waxed jacket. Key features: large gold-tone branded snap buttons, traditional saddle pockets, cord collar and exaggerated elasticated cuffs for a contemporary touch. Part of Barbour's signature waxed jacket selection since 2010. SKU: LWX1403BK71. Price: $425.00 (USD). Full-product images (multiple angles and detail shots) are provided on the product page."
        },
        "price": {
          "current_value": 425,
          "compare_at_value": 425,
          "currency": "USD"
        },
        "images": [
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image (primary)",
            "position": 1,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-0",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw3435dec4/images/LWX1403BK71/LWX1403BK71_03getthelook.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 2",
            "position": 2,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-1",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw433521eb/images/LWX1403BK71/LWX1403BK71_04back.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 3",
            "position": 3,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-2",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwb09d0c6f/images/LWX1403BK71/LWX1403BK71_05detaila.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 4",
            "position": 4,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-3",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwebbb5a93/images/LWX1403BK71/LWX1403BK71_05detailb.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 5",
            "position": 5,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-4",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw6cc4cf07/images/LWX1403BK71/LWX1403BK71_05detailc.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 6",
            "position": 6,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-5",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04f04054/images/LWX1403BK71/LWX1403BK71_05detaild.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 7",
            "position": 7,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-6",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          }
        ],
        "options": [
          {
            "name": "Color",
            "position": 1,
            "values": [
              "Black-Classic"
            ]
          },
          {
            "name": "Size",
            "position": 2,
            "values": [
              "US 2",
              "US 4",
              "US 6",
              "US 8",
              "US 10",
              "US 12",
              "US 14",
              "US 16"
            ]
          }
        ],
        "variants": [
          {
            "id": "variant-1770040913275-0",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 2",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 2",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 2 variant image",
              "position": 1,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-0",
              "variant_ids": [
                "variant-1770040913275-0"
              ]
            }
          },
          {
            "id": "variant-1770040913275-1",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 4",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 4",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 4 variant image",
              "position": 2,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-1",
              "variant_ids": [
                "variant-1770040913275-1"
              ]
            }
          },
          {
            "id": "variant-1770040913275-2",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 6",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 6",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 6 variant image",
              "position": 3,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-2",
              "variant_ids": [
                "variant-1770040913275-2"
              ]
            }
          },
          {
            "id": "variant-1770040913275-3",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 8",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 8",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 8 variant image",
              "position": 4,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-3",
              "variant_ids": [
                "variant-1770040913275-3"
              ]
            }
          },
          {
            "id": "variant-1770040913275-4",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 10",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 10",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 10 variant image",
              "position": 5,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-4",
              "variant_ids": [
                "variant-1770040913275-4"
              ]
            }
          },
          {
            "id": "variant-1770040913275-5",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 12",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 12",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 12 variant image",
              "position": 6,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-5",
              "variant_ids": [
                "variant-1770040913275-5"
              ]
            }
          },
          {
            "id": "variant-1770040913275-6",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 14",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 14",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 14 variant image",
              "position": 7,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-6",
              "variant_ids": [
                "variant-1770040913275-6"
              ]
            }
          },
          {
            "id": "variant-1770040913275-7",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 16",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 16",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 16 variant image",
              "position": 8,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-7",
              "variant_ids": [
                "variant-1770040913275-7"
              ]
            }
          }
        ],
        "store_canonical_url": "https://www.barbour.com/",
        "store_domain": "www.barbour.com",
        "platform": null,
        "platform_id": "LWX1403BK71",
        "description_html": "*content*"
        "product_type": "JACKETS",
        "google_product_category_id": "5598",
        "google_product_category_path": "Apparel & Accessories > Clothing > Outerwear > Coats & Jackets",
        "tags": [
          "JACKETS"
        ],
        "video_url": null,
        "review_count": null,
        "average_rating": null,
        "rating_scale": 5,
        "faqs": null,
        "reviews": null,
        "updated_at": "2026-02-02T14:02:32.789Z",
        "enable_enrichment": true,
        "enable_reviews": false,
        "enable_image_tags": false,
        "enable_full_html": false,
        "brand_pdp": null,
        "similar_products": null,
        "reddit_insights": null,
        "enable_brand_pdp": false,
        "enable_similar_products": false,
        "enable_reddit_insights": false
      }
    },
    ...
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_items": 8,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

Polling Strategy

For best results when waiting for completion:

1. Initial Poll: Check status immediately after receiving execution_id
2. Polling Interval: Wait 5-10 seconds between polls for running executions
3. Exponential Backoff: Consider increasing wait time for long-running searches
4. Timeout: Set a maximum wait time based on your application’s requirements
5. Progress Tracking: Monitor meta.progress to see real-time progress
6. Cancellation: If a search is taking too long or you need to stop it, use DELETE /v2/agentic-search/{execution_id} to stop running executions