border.bot
Skip the product story

HS codes and landed cost for cross-border parcels

Paste a product page or describe the product. border.bot returns the tariff code for the destination country and the duty, import tax and fees due when the parcel arrives.

Create a free accountTry the free classifier

How border.bot handles a shipment, from product page to checkout

  1. Read the product page

    Paste a product URL or type a description. We read the title, brand, materials and price from the page and look for the country of origin in its product data or text. When the page doesn’t say where the item was made, we estimate it and show the evidence.

    Product page

    URLhttps://shop.example/products/heavyweight-tee
    Title
    Heavyweight crew-neck T-shirt
    Material
    100% cotton jersey knit
    Price
    $24.00
    Made in
    Vietnam, from “Made in Vietnam” on the product page

  2. Classify it for the destination

    The product is matched against the destination’s tariff: the 10-digit HTS for the US, 10-digit commodity codes for the UK and Canada, CN and TARIC codes for the EU, and the 6-digit HS code for other countries. Each level of the code comes with its official description and a confidence score.

    US HTS code, 10 digits

    HS code 6109.10.00.12

    1. 61Articles of apparel and clothing accessories, knitted or crocheted
    2. 6109T-shirts, singlets, tank tops and similar garments, knitted or crocheted
    3. 6109.10Of cotton
    4. 6109.10.00.12The 10-digit US statistical line the shipment is declared under
    High confidence

  3. Calculate duty, tax and fees

    Duty, import tax and customs fees are calculated for that code, origin and destination, one line per charge with the rate used. Added to the goods and shipping, they give the landed cost.

    Landed cost, Vietnam to the United States

    Goods
    From the product page
    $24.00
    Shipping
    Your carrier rate
    $6.50
    Duty
    For this code and origin
    $5.40
    Fees
    Customs processing
    $1.10
    Taxes
    No import tax on this item
    $0.00
    Landed cost$37.00

    Illustrative figures. Rates change, so run the calculator for a current answer.

  4. Charge it at checkout

    With the landed cost known, you can collect duty and tax at checkout so the customer pays nothing on delivery, and the customs declaration carries the right code and origin. Every result is saved in your account.

    Customs status

    CLEARED

    Delivered to Los Angeles, United States

    Declared as 6109.10.00.12, made in Vietnam. Duty was paid at checkout.

Classification

Send a product description, a product page URL or both, with the destination country. You get the tariff code that country’s customs expects, the official description at each level of the code, a confidence score, the reasoning and the closest alternatives.

Results with low confidence are flagged for review. For high-value or regulated goods, have a licensed customs broker confirm the code or ask customs for a binding ruling.

Tariff schedule used for each destination
DestinationTariffCode
United StatesHarmonized Tariff Schedule (HTS)10 digits
United KingdomUK Global Tariff10 digits
European UnionCombined Nomenclature (CN) and TARIC8 or 10 digits
CanadaCustoms Tariff10 digits
Other countriesHarmonized System (HS)6 digits
Try the free classifier

United States, US HTS (10-digit)

High confidence

Classification result: 6109.10.00.12

T-shirts, singlets, tank tops and similar garments, knitted or crocheted, of cotton

Where the code comes from

  1. Chapter61Articles of apparel and clothing accessories, knitted or crocheted
  2. Heading6109T-shirts, singlets, tank tops and similar garments, knitted or crocheted
  3. Subheading6109.10Of cotton
High confidence92%

Reasoning

A T-shirt knitted from cotton jersey falls in chapter 61 (knitted apparel), heading 6109 (T-shirts and singlets) and subheading 6109.10 because cotton is the main material.

Country of origin

Vietnam, found in the page text (high confidence).

Evidence: “Made in Vietnam”

Confirm the origin with your supplier before you declare it.

Alternatives considered

  • 6105.10Men’s or boys’ shirts, knitted or crocheted, of cottonLow confidence
  • 6110.20Jerseys, pullovers, sweatshirts and similar articles, knitted, of cottonLow confidence
Calculate landed cost with this code
Example result: the T-shirt above, classified for the United States. Figures are illustrative.

Landed cost

Give an HS code, or a description to classify first, with the country of origin, the destination, the total goods value and the shipping cost. You get each duty, tax and fee line with the rate used, the de minimis check for the destination and the total in the destination’s currency.

Measures that apply only under certain conditions are listed separately and not added to the total. Carrier brokerage and handling fees are not included.

Destinations: United States, United Kingdom, Canada, European Union (all 27 member states). Other destinations are checked when you run a calculation, and you’re told if one isn’t covered yet.

Try the free calculator
How a landed cost is built, for a destination that charges duty on goods plus shipping
LineCalculationAmount
GoodsInvoice value100.00
ShippingCarrier rate10.00
Customs valueGoods plus shipping110.00
Duty10% of the customs value11.00
Import VAT20% of customs value plus duty24.20
Landed costGoods, shipping, duty and VAT145.20
Hypothetical rates of 10% duty and 20% VAT, to show the mechanics. The calculator uses the real rates for your code, origin and destination.

REST API

Classify and calculate from your own systems: the checkout, the product catalogue, an ERP or shipping software. Requests and responses are JSON over HTTPS.

  • Authenticate with a workspace API key in the Authorization header.
  • Errors come back as JSON with a code such as insufficient_credits or rate_limited.
  • Repeating a request with the same idempotency key returns the first result without charging again.
  • Calls use the same credits as the dashboard and the MCP server.
Read the quickstartAPI reference (opens in a new tab)
Request
curl https://api.border.bot/v1/classify \
  -H "Authorization: Bearer $BORDERBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Heavyweight crew-neck T-shirt, 100% cotton jersey knit",
    "destinationCountry": "US",
    "originCountry": "VN"
  }'
Response (example, trimmed)
{
  "result": {
    "hsCode": "6109100012",
    "hsCodeFormatted": "6109.10.00.12",
    "nomenclature": "us",
    "confidence": "high",
    "needsReview": false,
    "hierarchy": [
      { "level": "chapter", "code": "61", "description": "Articles of apparel … knitted or crocheted" },
      { "level": "heading", "code": "6109", "description": "T-shirts, singlets, tank tops …" },
      { "level": "subheading", "code": "610910", "description": "Of cotton" }
    ],
    "alternatives": [ … ]
  },
  "credits": { "charged": 1, "balance": 99 }
}

Use border.bot from Claude, ChatGPT, Codex, Cursor and 30 other MCP clients

Add the border.bot MCP server to your AI client and sign in with your border.bot account. The assistant can then classify products and calculate landed cost during a conversation. Each call uses credits from the workspace you pick when you connect.

MCP server URL

https://api.border.bot/mcp
Setup steps for all 34 clients

What’s the HS code for a 100% cotton crew-neck T-shirt shipped from Vietnam to the US, and what will it cost to land at $24?

Called border.bot: classify, then calculate landed cost

The border.bot classifier returns 6109.10.00.12 (knitted T-shirts of cotton) with high confidence. I also ran the landed cost: the duty, fee and tax lines and the total the customer pays are below.

Example conversation in Claude

Pricing

Credits are prepaid and there is no subscription. A classification uses 1 credit and a landed-cost calculation 1 credit. Packs start at $19.00 for 100 credits, and new accounts get 10 credits free. Credits for a failed call are refunded automatically.

Full pricing
Credit packs
PackCreditsPrice
Starter100$19.00$0.19 per credit
GrowthMost popular500$79.00$0.16 per credit
Scale2,000$249.00$0.12 per credit
Volume10,000$990.00$0.10 per credit

Free classifier, calculator and origin finder

The free tools work without an account: 3 free runs per visitor every 30 days, shared between them.

HS code classifierLanded cost calculatorCountry of origin finder

Common questions

What does border.bot do?

It finds the HS code for a product and calculates the duty, import tax, fees and total landed cost of shipping it to another country. You can use it in the web dashboard, through the REST API, or from Claude, ChatGPT, Codex, Cursor and other AI clients through our MCP server.

Which countries and tariff schedules do you cover?

Classification returns 10-digit codes for the US (HTS), the UK and Canada, CN and TARIC codes for the EU, and the 6-digit HS code for every other destination. Landed cost calculation covers the US, the UK, Canada, all 27 EU member states and more destinations, checked when you run it.

How accurate is the classification?

Each result shows the official description at every level of the code, a confidence score, the reasoning and the closest alternatives, and low-confidence results are flagged for review. Treat it as a well-documented first answer. For high-value, regulated or disputed goods, have a licensed customs broker confirm it or ask the customs authority for a binding ruling.

How does pricing work?

You buy prepaid credit packs and there is no subscription. Each classification or landed-cost calculation uses credits, the cost of every action is listed on the pricing page, and credits for a failed call are refunded automatically. New accounts start with free credits.

Can I use border.bot from Claude, ChatGPT, Codex or Cursor?

Yes. Add our remote MCP server to your client, sign in with your border.bot account and choose which workspace pays. The assistant can then classify products and calculate landed cost in the conversation, using the same credits as the dashboard. The MCP page has setup steps for each supported client.

Is the free classifier really free?

Yes. The free HS code classifier, landed cost calculator and country of origin finder give each visitor a few runs without an account. Cloudflare Turnstile and a usage limit stop automated abuse. Create an account when you need more.

What happens to the product data I send?

We use it to produce the result and keep it in your workspace history so you can find it again. Payments are handled by Stripe and card details never reach our servers. The security page explains sign-in, API keys, MCP access and data handling in detail.

Guides

All guides

Create an account

New accounts get 10 free credits. You get the dashboard, an API key and the MCP server, and you buy more credits when you need them.

Create a free accountContact us