Check whether the categories assigned to each item actually describe it.
GraphQL
The categoriesValidate mutation validates whether each item's supplied categories correctly describe the item. For every item you submit, it returns a verdict and a confidenceScore. When the verdict is WRONG, the response also returns plausible alternative categories drawn from your organization's category universe.
Use it to catch mis-categorized items before incorrect categories affect downstream classification, landed cost, or restriction results—and to suggest the right category back to whoever entered the item.
Each item in the response carries a verdict and a confidenceScore (0–1) expressing the model's confidence in that verdict.
Verdict↕
Meaning↕
CORRECT
The item plausibly belongs in the assigned categories.
WRONG
The item clearly does not belong in the assigned categories.
When the verdict is WRONG, suggestedCategories is populated with plausible alternatives from your organization's category universe. Each suggestion has its own category hierarchy (root → leaf) and a confidence score—the model's probability that it is the best-fit category, sorted descending. When the verdict is CORRECT, suggestedCategories is empty.
Submit one or more items in a single request. name and categories are required for each item; including optional details like description, brand, material, and amount improves accuracy. The example below validates two items—one correctly categorized and one clearly mis-categorized.
Category validation
Category validation
Check whether the categories assigned to each item actually describe it.
GraphQL
The
categoriesValidatemutation validates whether each item's supplied categories correctly describe the item. For every item you submit, it returns averdictand aconfidenceScore. When the verdict isWRONG, the response also returns plausible alternative categories drawn from your organization's category universe.Use it to catch mis-categorized items before incorrect categories affect downstream classification, landed cost, or restriction results—and to suggest the right category back to whoever entered the item.
Verdicts and confidence
Each item in the response carries a
verdictand aconfidenceScore(0–1) expressing the model's confidence in that verdict.CORRECTWRONGWhen the verdict is
WRONG,suggestedCategoriesis populated with plausible alternatives from your organization's category universe. Each suggestion has its owncategoryhierarchy (root → leaf) and aconfidencescore—the model's probability that it is the best-fit category, sorted descending. When the verdict isCORRECT,suggestedCategoriesis empty.Validate categories via API
Submit one or more items in a single request.
nameandcategoriesare required for each item; including optional details likedescription,brand,material, andamountimproves accuracy. The example below validates two items—one correctly categorized and one clearly mis-categorized.mutation CategoriesValidate($input: [CategoryValidateInput!]!) {categoriesValidate(input: $input) {idnamecategoriesverdictconfidenceScoresuggestedCategories {categoryconfidence}}}Input fields
nameString!categories[String!]!amountDecimalcurrencyCodeCurrencyCodebrandStringdescriptionStringmaterialStringglobalTradeItemNumberStringimageUrlStringThe descriptive fields are echoed back on each
CategoryValidationin the response, so every stored validation is self-describing.CategoryValidateInput
categoriesValidate
Was this page helpful?