Free API + tools
Import decisions, in your workflow.
Tandom gives US industrial sourcing teams free API access to HTS reference data, duty calculations, AD/CVD screening, entry-related signals, and approved read-only AI tools.
Use it to compare candidate products and origins before RFQs, purchase orders, and import decisions. Your team remains responsible for the final classification, valuation, origin, scope, admissibility, and filing decisions.
Make a first call
Available nowVersioned API requests use a Tandom API key in the Authorization header. Start with a single duty scenario, then use the full reference for request and response schemas.
cURL
curl https://api.tandom.ai/v1/duty/calculate \ -H "Authorization: Bearer tk_live_..." \ -G \ -d "hts=7307.91.50.10" \ -d "origin=CN" \ -d "value=10000"
Access
Free access, with fair-use limits
Tandom API keys, public data, calculations, and approved MCP tools are free to use. Fair-use safeguards apply by account and operation so the shared service remains reliable.
Available public API
Built around import decisions
These public endpoints are available today for authenticated API requests. The live reference is the source of truth for parameters, schemas, and response details.
Compare import-duty scenarios
Available nowModel the US duty stack for a candidate HTS code, country of origin, customs value, and shipment facts. Use the GET form for a direct calculation or POST when you need structured valuation adjustments.
This is an import-cost input, not a supplier quote or a final customs entry determination.
Public endpoints
- GET/v1/duty/calculate
Calculate one duty scenario from query parameters.
- POST/v1/duty/calculate
Calculate with structured valuation inputs.
Example: one sourcing scenario
curl https://api.tandom.ai/v1/duty/calculate \ -H "Authorization: Bearer tk_live_..." \ -G \ -d "hts=7307.91.50.10" \ -d "origin=CN" \ -d "value=10000"
Screen AD/CVD exposure
Available nowSearch active orders, screen a product and origin, retrieve point-in-time rates, or request a fuller case-by-case report. These calls help sourcing teams identify candidates that need deeper scope and rate review before an award.
AD/CVD scope text controls. HTS matches and automated analysis are decision-support signals, not legal scope determinations.
Public endpoints
- GET/v1/adcvd/check
Screen a product, origin, and optional manufacturer or exporter.
- GET/v1/adcvd/orders
Search the order catalog by product, country, status, or HTS signal.
- GET/v1/adcvd/rates-at
Retrieve the rate in effect for a case and date.
- POST/v1/adcvd/report
Generate a case-by-case analysis from structured product facts.
Example: screen a candidate origin
curl https://api.tandom.ai/v1/adcvd/check \ -H "Authorization: Bearer tk_live_..." \ -G \ -d "htsCode=7307.91.50.10" \ -d "country=CN" \ --data-urlencode "productDescription=stainless steel forged flanges"
Research HTS context
Available nowSearch existing HTS rows, browse a chapter, walk a code hierarchy, and retrieve applicable section, chapter, heading, or subheading notes. This gives a sourcing comparison the tariff context behind a candidate code.
Reference search explains existing codes. It does not classify a new product from a description.
Public endpoints
- GET/v1/hts/search
Search HTS rows by text or code.
- GET/v1/hts/browse
Browse by chapter or parent prefix.
- GET/v1/hts/hierarchy
Retrieve the hierarchy around one code.
- GET/v1/hts/notes
Retrieve legal notes for a code or chapter.
Example: search a product description
curl https://api.tandom.ai/v1/hts/search \ -H "Authorization: Bearer tk_live_..." \ -G \ --data-urlencode "q=stainless steel flanges"
Check entry-related signals
Available nowCheck Partner Government Agency tariff flags and deterministic Chapter 99 applicability for a candidate HTS code and origin. These signals help teams surface document, agency, and additional-duty questions earlier in sourcing.
PGA flags identify likely review or document requirements; they do not establish admissibility.
Public endpoints
- GET/v1/pga/check
Check likely PGA flags for an HTS code.
- GET/v1/chapter99/applicable
Check structured Chapter 99 applicability by HTS code and country.
Example: check an origin and HTS pair
curl https://api.tandom.ai/v1/chapter99/applicable \ -H "Authorization: Bearer tk_live_..." \ -G \ -d "htsCode=7307.91.50.10" \ -d "country=CN"
Use approved tools from AI workflows
Available nowThe API-key-gated MCP endpoint supports discovery and calls for the reviewed public tool set. Connect an MCP client to the canonical remote server or send JSON-RPC requests through the versioned API.
The public MCP surface is read-only. Unreleased and workspace-writing tools are not exposed.
Public endpoints
- POST/v1/mcp
Send MCP JSON-RPC initialize, tools/list, or tools/call requests.
Example: list callable tools
curl https://api.tandom.ai/v1/mcp \
-H "Authorization: Bearer tk_live_..." \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'Separate service
API data is free. Supplier development is a paid service.
The API helps your team analyze an import decision; it does not develop suppliers for you. In a Tandom sourcing project, we search for alternative manufacturers, build comparable RFQs, organize technical and commercial evidence, model landed-cost and import risk, and support first-order readiness. Your team keeps the supplier and award decisions.
Decision support, with human review
Tandom returns regulatory data, calculations, citations, and screening signals. Confirm material classifications, origin, valuation, AD/CVD scope, agency requirements, and filing treatment with your customs broker, trade counsel, or other qualified reviewer before acting.