---
title: "Verify an item's HS code"
method: POST
path: "/items/{id}/hs-code/verify"
tags: ["Items"]
---

# Verify an item's HS code

`POST /items/{id}/hs-code/verify`

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.

## Path parameters

- `id` string, required

## Request body

- ModelsHSCodeVerifyRequest
  - `note` string
  - `suggestion_id` string

## Response `200`

OK

- ModelsItemHSCode
  - `chapter` string — First 2 digits
  - `confidence_level` string — "high"/"medium"/"low"; empty for override
  - `confidence_score` number — carried over when verified; nil for override
  - `created_at` string
  - `decided_at` string
  - `decided_by` string — user email
  - `heading` string — First 4 digits
  - `hs_code` string — 6-10 digit HS/HTS code
  - `hs_code_description` string — Description of the HS code
  - `id` string
  - `item_id` string
  - `note` string — optional user note (esp. for overrides)
  - `source` string — "verified" or "override"
  - `source_suggestion_id` string — provenance of the verified suggestion
  - `subheading` string — First 6 digits
  - `updated_at` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/resourcly/apis/resourcly-api.md) · [All operations](https://skmtc.net/resourcly/apis/resourcly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/resourcly/resourcly-api/revisions/7f97d8cd0f1e/schema)