Get Product Type Proposal Run
GET/api/v2/product-types/proposals/:trackedJobLog
The status of a proposal run and, once status is completed, its proposals. Only the user who started the run can read it — any other run id answers 404.
products:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Response data:
id,status(pending|processing|completed|failed|cancelled),progress_percentage- when completed:
proposals[],provider,tokens(LLM tokens used),product_count(products classified),applied_at(set once decisions were applied) - when failed:
error
Each proposal: product_id, sku, name, brand_name, current_product_type_id / current_product_type_path (what the product carries today), product_type_id / product_type_path (an existing leaf type that fits, else null), new_type_path (a Parent > Leaf path to create when no existing type fits, else null), is_new, confidence (0–1), reason.
Requires permission: product_types.index
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.