Per batch call
200
Products per call
One batch request classifies and prices up to 200 products in parallel, finishing in 3 to 5 minutes.
Product
The Classification and Landed-Cost API for High-Volume Importers
Freight forwarders, cross-border e-commerce platforms, postal and parcel operators, and bulk importers send thousands of products through customs every day. The GingerControl API turns a plain product description and country of origin into an HTS code and the complete tariff stack, so your systems can quote landed cost and prep entries without a human classifying every line.
Built for Whole Catalogs, Not One-Offs
Production tier
200K+
Classifications per day
Standard production capacity. Custom enterprise tiers scale up to 100K classifications per hour.
Developers
The full request, response, and error contract lives in the API reference.
API ReferenceOr email chen@gingercontrol.com for a test key.
Throughput figures describe standard production-tier API keys measured across live traffic. Actual capacity is sized to each customer's calling pattern and peak QPS. Classification output is research material for review by a licensed customs broker before filing.
From Product Line to Landed Cost in One Call
POST/v1/tariff
descriptionCotton T-shirt
countryVN
Send the Product and Origin
POST a product description and country of origin, one item or a batch of up to 200. No tariff schedule lookups, no broker queue.
6109.10.0012
MFN
301
232
Ginger Classifies and Calculates
The engine determines the HTS code, then assembles the full duty stack: MFN base rate plus Section 301, 232, 122, and every applicable Chapter 99 entry.
200 OK
hts_code
general_rate
Section 301
Section 232
Get Landed-Cost-Ready Data Back
One JSON response returns the HTS code and every duty layer, ready to drop into your landed-cost quote, entry prep, or pricing engine.
One Request In, the Full Tariff Picture Out
Send a description and an origin. Get back the HTS code and the complete duty breakdown in a single call. This is a marketing snapshot; the API reference documents every field, error code, and batch behavior.
Request
curl -X POST 'https://api.gingercontrol.com/openapi/v1/tariff' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d {
"description": "Cotton knit short sleeve T-shirt",
"country_of_origin": "VN"
}Response
{
"hts_code": "6109.10.0012",
"tariffs": {
"general_rate": "16.5%",
"special_rate": "Free",
"Section 301": [],
"Section 232 - Metals": [],
"Section 122": [
{ "code": "9903.03.01", "rate": "10%" }
]
}
}See the full API reference for batch requests, split-code components, error semantics, and rate limits.
What the API Gives Your Systems
Classify
HTS classification that holds up at catalog scale, including the composite goods most APIs quietly skip.
6109.10
6109.10
6109.10
6109.10
6109.10
HTS Classification at Catalog Scale
Send messy real-world product descriptions and get a 10-digit HTS code back. In our internal benchmark across 1,000+ products the engine reached 99.86% accuracy, and every result is research output for a licensed customs broker to review before filing.
Calculate
Not just the base rate. The whole stack that actually lands on the entry.
MFN
301
232
122
Ch 99
Total
The Full Landed Duty Stack
Every response carries the General (MFN) and Special rates plus Section 301, Section 232, Section 122, and all applicable Chapter 99 entries, so your landed-cost number reflects what customs will actually assess.
Integrate
Predictable contracts and clear failure modes, the things an ops team plans around.
POST/tariff1 item
POST/tariff/batch200
Single and Batch Endpoints
Classify one product for a live checkout quote, or push up to 200 items in one batch call for a nightly catalog run. Both endpoints share one response shape and one quota.
Who Builds On It
The API is built for operations that move high volumes of retail goods, groceries, and parcels through customs every day, where classifying line by line by hand simply does not scale.
Freight Forwarders
Classify and price a client's whole shipment manifest before the truck leaves, instead of waiting on a broker for every line.
Cross-Border E-Commerce
Show an accurate duty-inclusive landed cost at checkout so shoppers are not surprised by customs charges on delivery.
Postal and Parcel Operators
Run HTS codes and duties across high-volume inbound parcel streams to feed customs declarations and prepayment.
Marketplaces and Retail Platforms
Give thousands of third-party sellers correct HTS codes and duty estimates without staffing a classification team.
3PLs and Fulfillment
Bake classification and landed cost into onboarding so every new client catalog is entry-ready on day one.
ERP, TMS and Pricing Engines
Embed live duty data into the platform your own customers already use, with no tariff schedule to maintain.
The Job It Does
"We move thousands of SKUs a week. We cannot put a human on every line, but a wrong duty estimate at quote time costs us the deal or the margin."
What That Translates To
| Price landed cost before the goods move | One call returns the HTS code and full duty stack, fast enough for a checkout quote or a shipment manifest. |
|---|---|
| Handle whole catalogs, not single lookups | Batch endpoint processes up to 200 products per call and scales to 200K+ classifications a day. |
| Trust the number going into the quote | Full tariff stack with Section 301, 232, and 122, plus split-code component duties, designed for broker review before filing. |
API FAQ
Do I need to be a licensed customs broker to use the API?
+
No. The API returns research output: an HTS code and the full duty stack for your systems to use in quoting and prep. The result is designed to be reviewed by a licensed customs broker before it is used on a customs filing. It speeds the work up, it does not replace the broker's sign-off.
How fast is a classification?
+
A single product classification typically returns in well under a minute. A batch of up to 200 products runs in parallel and completes in roughly 3 to 5 minutes, which is what lets standard production keys handle 200K+ classifications a day.
Can the API give me a duty-inclusive landed cost?
+
It returns every duty layer that lands on the entry: the General (MFN) and Special rates plus Section 301, 232, 122, and applicable Chapter 99 entries. Combine that duty stack with your own freight and fees to produce a landed-cost figure for a quote or checkout.
How do I get an API key?
+
Request a test key and we deliver it through an offline channel such as email. Test keys carry a small quota and expire in 7 to 30 days, for development only. When you are ready to go live, we issue a production key sized to your calling pattern, IP allowlist, and peak QPS.
What are the batch limits?
+
The batch endpoint accepts up to 200 products per call. Each item reports its own status, so one unclassifiable product does not fail the whole batch, and both the single and batch endpoints draw from the same item quota under your key.
Where is the full technical documentation?
+
The API reference documents every endpoint, request and response field, error code, header, and rate-limit rule, with copy-paste curl examples. It is the page to build against once you have a key.
Put a Classifier Behind Your Operation
Request a test key to start integrating, or read the full API reference to build against the contract.
For general reference only. See compliance disclaimer.
Compliance Reminder
This is an HTS classification researcher. Results are for general reference, educational, and planning purposes only, designed to enable better communication between trade compliance teams, importers, and licensed customs brokers. Per CBP Ruling HQ H290535, providing HTS classifications beyond 6 digits for specific imports constitutes "customs business" under 19 U.S.C. § 1641. Do not use these results directly in customs entry documents without independent review by a licensed customs broker.
Read full compliance disclaimer →