Get Categorization Job Status and Mappings

Learn how to get the status of a categorization job with the Smart Categorization API.

EndpointMethodRequired fields
/public-api/categorize/status/{jobId}GETjobId

Use this request to get the status and result of a categorization job.

Sample response

{
  "id": "5f5a7f86-6e8d-4c1a-a2c7-9d8b7e6f5a4b",
  "clientVertexId": "5f5a7f86-6e8d-4c1a-a2c7-9d8b7e6f5a4c",
  "startTime": "2026-07-31T15:30:00Z",
  "endTime": "2026-07-31T15:30:08Z",
  "persistent": true,
  "numProducts": 1,
  "numIssues": 0,
  "blobUri": "https://example.blob.core.windows.net/client/jobOutputs/consolidated/5f5a7f86-6e8d-4c1a-a2c7-9d8b7e6f5a4b/job-5f5a7f86-6e8d-4c1a-a2c7-9d8b7e6f5a4b-consolidated.json",
  "retentionDays": 30,
  "result": [
    {
      "index": 1,
      "Name": "Wireless Mouse",
      "Reasoning": "The product title and description indicate a computer input device used with desktop and laptop computers.",
      "Category": "Computer Accessories",
      "Confidence": 0.98,
      "product_unique_id": "A12345",
      "web_search_enrichment": "Wireless mouse with USB receiver and ergonomic design.",
      "llm_confidence": "highly confident",
      "mdu_version_used_by_engine_for_categorization": "254",
      "used_existing_mapping": false
    }
  ],
  "status": "DONE"
}

Did this page help you?