latestSwagger 2.0Proprietary2026-08-17126191431.8 KB

7f97d8cd0f1e

Items

Verify an item's HS code

Marks an AI-suggested HS code as verified for the item. The decision persists and survives AI re-classification. If no suggestion_id is given, the highest-confidence suggestion is verified.

post/items/{id}/hs-code/verify

Path parameters

idstring required

Item ID

Request body

notestring

suggestion_idstring

Response

chapterstring

First 2 digits

confidence_levelstring

"high"/"medium"/"low"; empty for override

confidence_scorenumber

carried over when verified; nil for override

created_atstring

decided_atstring

decided_bystring

user email

headingstring

First 4 digits

hs_codestring

6-10 digit HS/HTS code

hs_code_descriptionstring

Description of the HS code

idstring

item_idstring

notestring

optional user note (esp. for overrides)

sourcestring

"verified" or "override"

source_suggestion_idstring

provenance of the verified suggestion

subheadingstring

First 6 digits

updated_atstring