Get categorization job status and mappings

Learn how to retrieve the current status and results of a categorization job that was previously submitted.

Endpoint

GET /public-api/categorize/status/{jobId}

Returns the current status and results for a previously submitted categorization job.

Authentication

All requests require a valid bearer token in the Authorization header.

Authorization: Bearer {ACCESS_TOKEN}

Path parameter

Property	Type	Required	Description
`jobId`	string	Yes	The UUID of the categorization job returned by the create endpoint.

Example

curl --request GET \
  --url https://smartcategorization.vertexcloud.com/public-api/categorize/status/7ecf0bb0-8a90-4fc0-8e51-7c2f1d5a553e \
  --header "Authorization: Bearer {ACCESS_TOKEN}"

Response

{
  "id": "7ecf0bb0-8a90-4fc0-8e51-7c2f1d5a553e",
  "clientVertexId": "4e0864e9-2a1d-4d8f-aeb7-2677f1a19462",
  "startTime": "2026-09-25T12:00:00Z",
  "endTime": "2026-09-25T12:00:20Z",
  "persistent": false,
  "numProducts": 1,
  "numIssues": 0,
  "status": "completed",
  "result": "Success"
}

Errors

Status	Description
`401 Unauthorized`	The bearer token is missing, expired, or invalid.
`403 Forbidden`	The caller does not have access to this job.
`404 Not Found`	The job ID does not exist.