Skip to main content
POST

Authorizations

Authorization
string
header
required

API key issued from the LandedFees dashboard under Settings > API keys. Format: sk_live_... (production) or sk_test_... (sandbox). Pass in the Authorization: Bearer <key> header.

Headers

Idempotency-Key
string

Client-generated unique string (recommended UUID v4). Repeating the same key within 24 hours returns the cached response for the original request body. Different bodies with the same key return HTTP 409.

Required string length: 8 - 128
Example:

"e4c1d2a0-8f6b-4c9d-a123-2f8b7c5e9d10"

Body

application/json
description
string
required
Required string length: 3 - 2000
destination_country
string
required
Required string length: 2
hs_code_printed
string | null
Maximum string length: 64
confidence_threshold
number
Required range: 0 <= x <= 1

Response

Classification completed.

hs_6_code
string
Example:

"851762"

Example:

"8517.62.00.90"

confidence
number
Required range: 0 <= x <= 1
reason
string
needs_review
boolean
candidates
object[]
disagreement_with_printed
boolean

True when a supplied hs_code_printed differs from the recommendation.