> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcatalog.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Agentic Search Status

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

<Tip>
  **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
</Tip>

<Note>
  **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}`](/v2/api-reference/endpoints/search/cancel-agentic-search-execution) to stop the execution.
</Note>

## Request

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication
</ParamField>

<ParamField path="execution_id" type="string" required>
  The execution ID returned from [`POST /v2/agentic-search`](/v2/api-reference/endpoints/search/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.
</ParamField>

### Query Parameters

<ParamField query="page" type="number" default="1" optional>
  Page number for paginated results (only applicable when status is "completed")

  **Minimum:** 1
</ParamField>

<ParamField query="page_size" type="number" default="50" optional>
  Number of results per page (only applicable when status is "completed")

  **Maximum:** 100
</ParamField>

## Response

<ResponseField name="execution_id" type="string">
  The execution identifier
</ResponseField>

<ResponseField name="status" type="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
</ResponseField>

<ResponseField name="error" type="string | null">
  Error message if the execution failed, otherwise `null`
</ResponseField>

<ResponseField name="data" type="array" optional>
  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.

  <Expandable title="Product Result" defaultOpen>
    <ResponseField name="url" type="string">
      Original URL that was processed
    </ResponseField>

    <ResponseField name="success" type="boolean">
      Whether the product was successfully processed
    </ResponseField>

    <ResponseField name="product" type="object | null">
      Product object

      <Expandable title="Product Object" defaultOpen>
        <ResponseField name="title" type="string">
          Product title
        </ResponseField>

        <ResponseField name="description" type="string">
          Detailed product description
        </ResponseField>

        <ResponseField name="url" type="string">
          Product URL
        </ResponseField>

        <ResponseField name="brand" type="string | null">
          Product brand name
        </ResponseField>

        <ResponseField name="product_category" type="string | null">
          Full product category breadcrumb path
        </ResponseField>

        <ResponseField name="google_product_category_id" type="string | null">
          Google product category identifier
        </ResponseField>

        <ResponseField name="google_product_category_path" type="string | null">
          Full Google product category path
        </ResponseField>

        <ResponseField name="condition" type="string | null">
          Product condition (e.g. "new", "used", "refurbished")
        </ResponseField>

        <ResponseField name="availability" type="string | null">
          Availability status string (e.g. "in\_stock", "out\_of\_stock", "preorder", "backorder")
        </ResponseField>

        <ResponseField name="price" type="string | null">
          Product price as a value and currency string (e.g. "1628 USD")
        </ResponseField>

        <ResponseField name="sale_price" type="string | null">
          Sale price as a value and currency string (e.g. "1365 USD")
        </ResponseField>

        <ResponseField name="material" type="string | null">
          Product material description
        </ResponseField>

        <ResponseField name="gender" type="string | null">
          Target gender (e.g. "male", "female", "unisex")
        </ResponseField>

        <ResponseField name="age_group" type="string | null">
          Target age group (e.g. "adult", "kids", "toddler", "infant", "newborn")
        </ResponseField>

        <ResponseField name="size_system" type="string | null">
          Size system used (e.g. "US", "UK", "EU")
        </ResponseField>

        <ResponseField name="dimensions_unit" type="string | null">
          Unit for dimension values (e.g. "in", "cm")
        </ResponseField>

        <ResponseField name="weight" type="string | null">
          Product weight value
        </ResponseField>

        <ResponseField name="height" type="string | null">
          Product height value
        </ResponseField>

        <ResponseField name="length" type="string | null">
          Product length value
        </ResponseField>

        <ResponseField name="width" type="string | null">
          Product width value
        </ResponseField>

        <ResponseField name="item_weight_unit" type="string | null">
          Unit for weight value (e.g. "lb", "kg")
        </ResponseField>

        <ResponseField name="images" type="array">
          Array of image objects.
        </ResponseField>

        <Expandable title="Image object">
          <ResponseField name="url" type="string">
            Image URL
          </ResponseField>

          <ResponseField name="alt_text" type="string | null">
            Alt text
          </ResponseField>
        </Expandable>

        <ResponseField name="variants" type="array">
          Array of variant objects.
        </ResponseField>

        <Expandable title="Variant object">
          <ResponseField name="variant_id" type="string">
            Variant ID
          </ResponseField>

          <ResponseField name="sku" type="string | null">
            SKU
          </ResponseField>
        </Expandable>

        <ResponseField name="shipping" type="string | null">
          Shipping information
        </ResponseField>

        <ResponseField name="is_eligible_search" type="string">
          Whether the product is eligible for search. "true" or "false".
        </ResponseField>

        <ResponseField name="is_eligible_checkout" type="string">
          Whether the product is eligible for checkout. "true" or "false".
        </ResponseField>

        <ResponseField name="review_count" type="number | null">
          Number of reviews
        </ResponseField>

        <ResponseField name="star_rating" type="number | null">
          Average star rating (e.g. 4.8)
        </ResponseField>

        <ResponseField name="rating_scale" type="number | null">
          Rating scale (e.g. 5)
        </ResponseField>

        <ResponseField name="reviews" type="array | null">
          Array of review objects.
        </ResponseField>

        <Expandable title="Review object">
          <ResponseField name="date" type="string | null">
            Review date
          </ResponseField>

          <ResponseField name="title" type="string | null">
            Review title
          </ResponseField>

          <ResponseField name="rating" type="number | string | null">
            Rating
          </ResponseField>

          <ResponseField name="content" type="string | null">
            Review body
          </ResponseField>

          <ResponseField name="image_url" type="string | null">
            Review image URL
          </ResponseField>

          <ResponseField name="reviewer_name" type="string | null">
            Reviewer name
          </ResponseField>
        </Expandable>

        <ResponseField name="similar_products" type="array | null">
          Similar products when similar products discovery is enabled.
        </ResponseField>

        <Expandable title="Similar product object">
          <ResponseField name="url" type="string">
            Product URL
          </ResponseField>

          <ResponseField name="brand" type="string | null">
            Brand name
          </ResponseField>

          <ResponseField name="title" type="string">
            Product title
          </ResponseField>

          <ResponseField name="similarity" type="string">
            "high" | "medium" | "low"
          </ResponseField>
        </Expandable>

        <ResponseField name="brand_pdp" type="object | null">
          Brand product detail page lookup result, identifying the original brand's listing for this product.
        </ResponseField>

        <Expandable title="Brand PDP object">
          <ResponseField name="brandName" type="string">
            Brand name
          </ResponseField>

          <ResponseField name="brandDomain" type="string">
            Brand website domain
          </ResponseField>

          <ResponseField name="brandPdpUrl" type="string">
            URL to the product on the brand's own website
          </ResponseField>

          <ResponseField name="productTitle" type="string">
            Product title on the brand's website
          </ResponseField>
        </Expandable>

        <ResponseField name="attributes" type="object | null">
          Product attributes when AI enrichment is enabled.
        </ResponseField>

        <Expandable title="Attributes object">
          Key-value object from AI enrichment. Structure is product-dependent; no fixed schema. May include semantic attributes (e.g. color, summary, features, material, placement, durability, care\_instructions, additional\_attributes) and other enriched fields.
        </Expandable>

        <ResponseField name="platform" type="string | null">
          E-commerce platform (e.g. "shopify")
        </ResponseField>

        <ResponseField name="platform_id" type="string | null">
          Platform-specific ID
        </ResponseField>

        <ResponseField name="is_digital" type="boolean | null">
          Whether the product is a digital/downloadable item
        </ResponseField>

        <ResponseField name="deep_research" type="object | null">
          In-depth product research organized by dimension (e.g. ergonomics, materials, competitive analysis). Structure varies by product category.
        </ResponseField>

        <ResponseField name="q_and_a" type="array | null">
          Array of Q\&A objects.
        </ResponseField>

        <Expandable title="Q&A object">
          <ResponseField name="question" type="string">
            Question
          </ResponseField>

          <ResponseField name="answer" type="string">
            Answer
          </ResponseField>

          <ResponseField name="confidence" type="string | null">
            Confidence level: "high", "medium", or "low"
          </ResponseField>

          <ResponseField name="category" type="string | null">
            Category of the question (e.g. "durability", "compatibility", "maintenance", "performance", "technical")
          </ResponseField>
        </Expandable>
      </Expandable>
    </ResponseField>

    <ResponseField name="outcome" type="string" optional>
      Machine-readable reason for failure (only present when success is false and a specific reason is available)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object" optional>
  Pagination metadata for the results (only present when status is "completed" and data is returned)

  <Expandable title="Pagination Properties">
    <ResponseField name="page" type="number">
      Current page number
    </ResponseField>

    <ResponseField name="page_size" type="number">
      Number of items per page
    </ResponseField>

    <ResponseField name="total_items" type="number">
      Total number of products returned
    </ResponseField>

    <ResponseField name="total_pages" type="number">
      Total number of pages
    </ResponseField>

    <ResponseField name="has_next" type="boolean">
      Whether there is a next page
    </ResponseField>

    <ResponseField name="has_prev" type="boolean">
      Whether there is a previous page
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  Detailed metadata about the execution

  <Expandable title="Meta Object">
    <ResponseField name="query" type="string" optional>
      The search query used for this execution
    </ResponseField>

    <ResponseField name="progress" type="object | null">
      Real-time progress information (only available when status is "running")

      <Expandable title="Progress Object">
        <ResponseField name="products_processed" type="number">
          Number of products processed so far
        </ResponseField>

        <ResponseField name="products_total" type="number">
          Total number of products to process (up to 8)
        </ResponseField>

        <ResponseField name="percent_complete" type="number">
          Percentage of completion (0-100)
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="start_date" type="string | null">
      ISO 8601 timestamp when the execution started
    </ResponseField>

    <ResponseField name="stop_date" type="string | null">
      ISO 8601 timestamp when the execution stopped (only available when completed or failed)
    </ResponseField>

    <ResponseField name="duration_ms" type="number | null">
      Duration of the execution in milliseconds (only available when execution has started)
    </ResponseField>

    <ResponseField name="result" type="object" optional>
      Result statistics (only available when status is "completed")

      <Expandable title="Result Object">
        <ResponseField name="products_returned" type="number">
          Number of products returned in the response
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample dropdown>
  ```powershell cURL theme={null}
  # Check execution status
  curl -X GET "https://api.getcatalog.ai/v2/agentic-search/agentic-a1b2c3d4-1735123456789" \
    -H "x-api-key: $CATALOG_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  // Check execution status
  const executionId = 'agentic-a1b2c3d4-1735123456789';

  const response = await fetch(
    `https://api.getcatalog.ai/v2/agentic-search/${executionId}`,
    {
      headers: {
        'x-api-key': 'YOUR_API_KEY'
      }
    }
  );

  const data = await response.json();

  if (data.status === 'completed') {
    console.log(`Search completed!`);
    console.log(`Products found: ${data.meta.result?.products_returned || 0}`);
    console.log(`Duration: ${data.meta.duration_ms}ms`);
    console.log(`Products:`, data.data);
  } else if (data.status === 'running') {
    console.log('Search is still running...');
    if (data.meta.progress) {
      console.log(`Progress: ${data.meta.progress.percent_complete}% complete`);
    }
    // Optionally cancel if needed: DELETE /v2/agentic-search/{executionId}
  } else if (data.status === 'failed') {
    console.error(`Search failed: ${data.error}`);
  }
  ```

  ```python Python theme={null}
  import requests
  import time

  execution_id = 'agentic-a1b2c3d4-1735123456789'

  # Poll for completion
  while True:
      response = requests.get(
          f'https://api.getcatalog.ai/v2/agentic-search/{execution_id}',
          headers={'x-api-key': 'YOUR_API_KEY'}
      )
      
      data = response.json()
      
      if data['status'] == 'completed':
          print(f"Search completed!")
          print(f"Products found: {data['meta'].get('result', {}).get('products_returned', 0)}")
          print(f"Duration: {data['meta']['duration_ms']}ms")
          print(f"Products: {data.get('data', [])}")
          break
      elif data['status'] == 'running':
          print('Search is still running...')
          if data['meta'].get('progress'):
              progress = data['meta']['progress']
              print(f"Progress: {progress['percent_complete']}% complete")
          # Optionally cancel if needed: DELETE /v2/agentic-search/{execution_id}
          time.sleep(5)  # Wait 5 seconds before next poll
      elif data['status'] == 'failed':
          print(f"Search failed: {data['error']}")
          break
  ```
</RequestExample>

<ResponseExample>
  ```json Status: Completed theme={null}
  {
    "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,
          "similar_products": null,
          "enable_similar_products": false
        }
      },
      ...
    ],
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 8,
      "total_pages": 1,
      "has_next": false,
      "has_prev": false
    }
  }
  ```

  ```json Status: Running theme={null}
  {
    "execution_id": "agentic-a1b2c3d4-1735123456789",
    "status": "running",
    "error": null,
    "meta": {
      "query": "A Barbour jacket suitable for the office",
      "progress": {
        "products_processed": 0,
        "products_total": 8,
        "percent_complete": 0
      },
      "start_date": "2025-01-15T10:30:00.000Z",
      "stop_date": null,
      "duration_ms": 15000
    }
  }
  ```

  ```json Status: Failed theme={null}
  {
    "execution_id": "agentic-a1b2c3d4-1735123456789",
    "status": "failed",
    "error": "Execution failed. Please check the execution details or contact support.",
    "meta": {
      "query": "A Barbour jacket suitable for the office",
      "progress": null,
      "start_date": "2025-01-15T10:30:00.000Z",
      "stop_date": "2025-01-15T10:31:15.000Z",
      "duration_ms": 75000
    }
  }
  ```
</ResponseExample>

## 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}`](/v2/api-reference/endpoints/search/cancel-agentic-search-execution) to stop running executions
