すべてのドキュメントを閲覧

HSコードAPIリファレンス

ある版の1つのHSコードを、その名称、レベル、親コード、1つ下のレベルのコードとともに読み取ります。

概要

GET /v1/trade/hs-codes/{code}

GET /v1/trade/hs-codes/{code} は、ある版の1つのHSコードを返します。名称、レベル、親コード、1つ下のレベルのコードです。code は2桁、4桁、6桁です。

その版にないコードには、404 hs_code_not_found が返ります。版は相互に変換されないため、同じ6桁のコードが、ある版には存在し、別の版には存在しないことがあります。MCPツールは trade_get_hs_code で、同じパラメータを受け付けます。

リクエスト

2022年版の号851713(スマートフォン)と、実際のレスポンス:

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/trade/hs-codes/851713"
コード851713
{
  "code": "851713",
  "level": 6,
  "label": "Smartphones for wireless networks",
  "parent": "8517",
  "classification": "HS",
  "edition": "2022",
  "children": []
}

号にはその下のコードがないため、children は空です。

パラメータ

パラメータ場所種別必須デフォルト許容値と意味
codeパス文字列はいなし2桁、4桁、6桁のHSコード。例:85、8517、851713。ドットは付けません。他の形式には400が返ります。
editionクエリ文字列いいえ20222007、2012、2017、2022。他の値には400が返ります。

レスポンス

回答には次のフィールドがあります。

フィールド意味
codeコード。
level類は 2、項は 4、号は 6。
labelその版の言葉による、コードの名称。
parent1つ上のレベルのコード。類では null。
classificationHS。
edition版。
children1つ下のレベルのコード。それぞれ code、level、label、parent を持ちます。号では空。

その他の例

版にないコード

コード851713は2022年版で新設されました。2017年版にはないため、リクエストには404が返り、無料です:

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/trade/hs-codes/851713?edition=2017"
2017年版のコード851713
{
  "type": "https://narwhalapi.com/problems/hs-code-not-found",
  "title": "HS code not found",
  "status": 404,
  "detail": "HS 2017 has no code 851713.",
  "code": "hs_code_not_found",
  "request_id": "d8c40c41-aeaf-4b83-a315-c855697eafc3"
}

ソース

このルートはコードを保有し、貿易の数値は保有しないため、ソースは適用されません。

通貨

このルートは値を返さないため、通貨は適用されません。

ページング

このルートにはページングがありません。すべての子が1回の回答で返ります。

価格

コードが見つかったリクエストは1回の呼び出しで、1,000回あたり$2です。コードが見つからない場合と、その他すべてのエラーは無料です。

エラー

これらのエラーは、request_id を含む共通のエラー形式で返されます。キーがない、または無効な場合(401)、残高が呼び出しの料金に満たない場合(402)、1分あたりのリクエストが多すぎる場合(429)は、すべてのルートに共通するアカウントのエラーです。APIエラーとクレジットを参照してください。

ステータスコード発生する場面
400invalid_querycode が2桁、4桁、6桁ではない場合、または edition が 2007、2012、2017、2022 のいずれでもない場合。
404hs_code_not_foundその版にそのようなコードがない場合。例:HS 2017 has no code 851713.

APIエラーとクレジット · 貿易データAPIリファレンス · 貿易の対象国

このページは役に立ちましたか?