전체 문서 탐색

HS 코드 API 레퍼런스

개정판의 HS 코드 하나를 이름, 단계, 상위 코드, 한 단계 아래 코드와 함께 읽습니다.

개요

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

GET /v1/trade/hs-codes/{code}는 개정판의 HS 코드 하나를 반환합니다. 이름, 단계, 상위 코드, 한 단계 아래 코드입니다. 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경로문자열예없음점 없이 85, 8517, 851713처럼 2자리, 4자리 또는 6자리 HS 코드. 다른 형식은 400을 반환합니다.
edition쿼리문자열아니요20222007, 2012, 2017 또는 2022. 다른 값은 400을 반환합니다.

응답

응답에는 다음 필드가 있습니다.

필드의미
code코드.
level류는 2, 호는 4, 소호는 6.
label개정판 표기에 따른 코드명.
parent한 단계 위의 코드. 류에서는 null.
classificationHS.
edition개정판.
children한 단계 아래의 코드이며, 각각 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,000회 호출당 $2입니다. 찾지 못한 코드와 그 밖의 모든 오류는 무료입니다.

오류

이 오류는 request_id가 포함된 공통 problem 형식을 사용합니다. 키가 없거나 유효하지 않은 경우(401), 잔액이 호출 요금보다 적은 경우(402), 분당 요청이 너무 많은 경우(429)는 모든 경로가 공통으로 가지는 계정 오류입니다. 자세한 내용은 API 오류 코드와 크레딧을 참고하세요.

상태코드발생 조건
400invalid_querycode가 2자리, 4자리 또는 6자리가 아니거나, edition이 2007, 2012, 2017, 2022가 아닙니다.
404hs_code_not_found개정판에 해당 코드가 없습니다. 예: HS 2017 has no code 851713.

API 오류 코드와 크레딧 · 무역 데이터 API 레퍼런스 · 무역 국가

이 페이지가 도움이 되었나요?