# Korea HS Code Import Requirements (세관장확인대상물품) (`kr-data/korea-hs-import-requirements`) Actor

Which Korean laws require a permit or certificate at customs for an HS code: law, document and issuing agency in English, from Korea Customs (세관장확인대상물품). Import or export; 10-digit HSK or 4/6-digit prefixes.

- **URL**: https://apify.com/kr-data/korea-hs-import-requirements.md
- **Developed by:** [KR Data](https://apify.com/kr-data) (community)
- **Categories:** E-commerce, Business
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 hs code checks

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Korea HS Code Import Requirements (세관장확인대상물품)

Find out **which Korean laws require a permit, certificate or confirmation at customs** before goods with a given **HS code** can be imported into or exported from South Korea. Data comes from the Korea Customs Service list of **items subject to customs confirmation** (세관장확인대상물품, Customs Act Article 226). For each 10-digit Korean HSK code you get, in English with the Korean originals:

- whether the code **requires customs confirmation** at all (`requiresCustomsConfirmation`)
- each **law** behind the requirement (e.g. Radio Waves Act, Cosmetics Act, Special Act on Imported Food Safety Control)
- the **document to present** to customs (e.g. *Broadcasting and communication equipment certification confirmation*)
- the **agencies that issue or confirm it** (e.g. National Radio Research Agency, MFDS, KTL, KTR)
- the date the requirement applies from, and the **official HSK description** (chapter > heading > subheading)

Give a full 10-digit HSK code, or a **4, 6 or 8-digit HS prefix** — the Actor expands it to every 10-digit Korean code under it (from the 2026 tariff, 11,327 codes). **No API key or Korean account needed.**

### Typical uses

- **Cross-border e-commerce and Amazon/Coupang sellers** — before shipping a SKU to Korea, see if it needs a KC, radio, food, cosmetics or drug confirmation document.
- **Freight forwarders, customs brokers and landed-cost / trade-compliance SaaS** — enrich HS codes with Korean regulatory requirements in English.
- **Export control screening** — export direction shows which goods need an export permit (e.g. waste, cultural heritage, narcotics, biological resources, wildlife).
- **AI agents** — "Do I need any certificate to import smartphones (HS 8517.13) into Korea?"

### Input

| Field | Description |
|---|---|
| `hsCodes` | One per line: a 10-digit HSK code (`3304991000`, `3304.99-1000`) or a 4/6/8-digit prefix (`8517.13`, `3004`). Product names are not accepted. Up to 100 lines. |
| `direction` | `import` (default), `export` or `both` (one result per code and direction). |
| `maxCodesPerEntry` | Default 30, up to 300. A prefix is expanded to at most this many 10-digit codes (in code order). |
| `onlyWithRequirements` | `true` = skip codes that need no confirmation; skipped codes are not charged. |

```json
{ "hsCodes": ["8517.13", "3304991000"], "direction": "import" }
```

### Output

One item per 10-digit HSK code and direction:

```json
{
  "input": "8517.13",
  "hsCode": "8517130000",
  "hsCodeFormatted": "8517.13-0000",
  "direction": "import",
  "status": "requirements_found",
  "requiresCustomsConfirmation": true,
  "description": "Telephone sets > Telephone sets, including smartphones and other telephones for cellular networks or for other wireless networks > Smartphones",
  "descriptionKo": "전화기 > 전화기(셀룰러 통신망용이나 그 밖의 무선통신망용의 스마트폰과 그 밖의 전화기를 포함한다) > 스마트폰",
  "descriptionPath": [ { "code": "85", "description": "Chapter 85 Electrical machinery and equipment ...", "descriptionKo": "제85류 ..." }, "..." ],
  "requirements": [
    {
      "lawCode": "23",
      "law": "Electrical Appliances and Consumer Products Safety Control Act",
      "lawKo": "전기용품 및 생활용품 안전관리법",
      "requiredDocument": "Electrical appliance and consumer product requirement confirmation",
      "requiredDocumentKo": "전기용품 및 생활용품 요건확인서",
      "effectiveFrom": "2022-01-01",
      "approvalAgencies": [
        { "code": "105", "name": "Korean Agency for Technology and Standards (KATS)", "nameKo": "기술표준원" },
        { "code": "314", "name": "Korea Testing Laboratory (KTL)", "nameKo": "한국산업기술시험원" }
      ]
    },
    {
      "lawCode": "39",
      "law": "Radio Waves Act",
      "lawKo": "전파법",
      "requiredDocument": "Broadcasting and communication equipment certification confirmation",
      "requiredDocumentKo": "방송통신기기인증확인서",
      "effectiveFrom": "2022-01-01",
      "approvalAgencies": [ { "code": "108", "name": "National Radio Research Agency (RRA)", "nameKo": "국립전파연구원" } ]
    }
  ],
  "error": null,
  "coverageNote": "Lists the customs-confirmation requirements (Customs Act Art. 226) only. ...",
  "source": "Korea Customs Service (관세청) items subject to customs confirmation (세관장확인대상물품), via data.go.kr; ...",
  "checkedAt": "2026-10-11T13:43:50+00:00"
}
```

| `status` | Meaning |
|---|---|
| `requirements_found` | At least one law requires a confirmation document for this code and direction. |
| `no_requirements` | Valid code, no customs-confirmation requirement listed. |
| `unknown_code` | Not a current Korean HSK code (or no code under the prefix) — free. |
| `invalid_input` | Empty line, product name, or wrong number of digits — free. |
| `lookup_failed` | The official source did not answer; retry later — free. |

### Limitations — what is not included

- **Only the customs-confirmation list.** `no_requirements` does **not** mean the goods are free to import: tariffs and VAT, quotas, origin rules, product registrations done before shipping and other conditions are not covered. Personal-use and sample exemptions that customs may apply are not shown either.
- **Requirements apply to the whole code.** Korean customs lists a law for an HS code even when only some products under it are regulated (e.g. only items that are drugs, or only wild species). Read it as "check whether your product falls under this law".
- **You need the HS code.** The Actor does not classify products from a name or photo. Korean 10-digit HSK codes are national: the first 6 digits match the international HS, the last 4 are Korean.
- **English names of laws, documents and agencies are our translations** (official English law titles where they exist); the Korean originals are always included. A law, document or agency not yet in our dictionary is returned with the Korean name only (`law`, `requiredDocument` or `name` = `null`).
- At most 500 code lookups per run (the source has a shared daily quota); split larger lists over several runs.

### Pricing

Pay per result: **$0.002 per HS code check** (`hs-code-check`) — one per 10-digit code and direction returned, with or without requirements. Unknown codes, invalid inputs, failed lookups and codes skipped by `onlyWithRequirements` are free.

### Use as an MCP tool (Claude, Cursor, other AI agents)

Add the Apify MCP server with this Actor:

```
https://mcp.apify.com?tools=kr-data/korea-hs-import-requirements
```

### Source and license

관세청_세관장확인대상물품(GW) (data.go.kr 15101589), 이용허락범위 제한 없음. HSK descriptions: 관세청_HS부호 단위별 품목명 (data.go.kr 15130660) and 관세청_HS부호 (15049722), 공공누리 제1유형 (출처표시) — source: Korea Customs Service.

### More Korean data from KR Data

- [Korea Business Check (KYB)](https://apify.com/kr-data/korea-business-verify) — business registration status, company profile, financials
- [Korean Address to English](https://apify.com/kr-data/korea-address) — official English address and postal code
- [Korean Law in English](https://apify.com/kr-data/korea-law) — official English text of Korean statutes
- [Korea Online Seller Registration Check](https://apify.com/kr-data/korea-ecommerce-seller-registry) — mail-order business registration (통신판매업) by business number
- [Korea Drug & Medical Device Recalls](https://apify.com/kr-data/korea-health-recalls) — recent MFDS recalls and sales suspensions
- [Korea Company Headcount](https://apify.com/kr-data/korea-company-headcount) — monthly National Pension headcount, hires and leavers
- [Korea Financial Company Lookup](https://apify.com/kr-data/korea-financial-institution-registry) — Korean banks, brokers and insurers with IDs and audit opinion
- [Korea Flood-Damaged Car Check](https://apify.com/kr-data/korea-flood-car-check) — flood-damage insurance records by license plate

# Actor input Schema

## `hsCodes` (type: `array`):

One per line: a Korean 10-digit HSK code (e.g. 3304991000 or 3304.99-1000) or a 4, 6 or 8-digit HS prefix (e.g. 8517.13, 3004), which is expanded to every 10-digit HSK code under it. Product names are not accepted. Up to 100 lines per run.

## `direction` (type: `string`):

Requirements differ for import and export. 'both' returns one result per code and direction.

## `maxCodesPerEntry` (type: `integer`):

A short prefix can cover dozens of 10-digit codes; only the first N (in code order) are checked. Each code and direction returned is one charged result.

## `onlyWithRequirements` (type: `boolean`):

Skip (and do not charge) codes that need no customs confirmation. Useful with short prefixes.

## Actor input object example

```json
{
  "hsCodes": [
    "8517.13",
    "3304991000"
  ],
  "direction": "import",
  "maxCodesPerEntry": 30,
  "onlyWithRequirements": false
}
```

# Actor output Schema

## `results` (type: `string`):

One item per 10-digit HSK code and direction (plus one per invalid or unknown entry).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "hsCodes": [
        "8517.13",
        "3304991000"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("kr-data/korea-hs-import-requirements").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "hsCodes": [
        "8517.13",
        "3304991000",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("kr-data/korea-hs-import-requirements").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "hsCodes": [
    "8517.13",
    "3304991000"
  ]
}' |
apify call kr-data/korea-hs-import-requirements --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,kr-data/korea-hs-import-requirements"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Z4BK7C7Bx6hQoTTTQ/builds/aEJgjPS2kXdAokuny/openapi.json