# Tandom API > U.S. customs, tariff, and trade-compliance data for AI agents and integrators. This file follows the [llms.txt convention](https://llmstxt.org/) — a structured index of the Tandom API, intended for LLM-driven dev tools (Claude, Cursor, Cody, custom agents) to consume without scraping HTML. - Hosted reference (Scalar): https://docs.tandom.ai/api - OpenAPI spec (JSON): https://docs.tandom.ai/api/openapi.json - OpenAPI spec (YAML): https://docs.tandom.ai/api/openapi.yaml - Postman collection: https://docs.tandom.ai/api/postman.json - Full Markdown dump: https://docs.tandom.ai/api/llms-full.txt **Authentication.** Every request needs `Authorization: Bearer tk_live_<32_chars>`. Get a key at https://tandom.ai/account/api-keys. **Errors.** All 4xx/5xx responses are RFC 7807 `application/problem+json` with `{ type, title, status, detail }`. Rate-limited responses (429) carry `Retry-After` + `X-RateLimit-*` headers. **Citations.** Every endpoint that returns rates, scope, or determinations also returns citations to the authoritative U.S. legal source (Federal Register, Commerce, USITC, court decisions). Every AI-derived field carries confidence + reasoning + verbatim supporting phrases. ## Duty Calculation - [calculateDuty](https://docs.tandom.ai/api/operations/calculateDuty.md): `GET /v1/duty/calculate` — Calculate full landed duty for one HTS line - [calculateDutyWithValuation](https://docs.tandom.ai/api/operations/calculateDutyWithValuation.md): `POST /v1/duty/calculate` — Calculate full landed duty (POST variant — accepts valuation adjustments) - [calculateDutyBatch](https://docs.tandom.ai/api/operations/calculateDutyBatch.md): `POST /v1/duty/calculate/batch` — Bulk duty calculation (closed beta) ## AD/CVD Intelligence - [checkAdcvd](https://docs.tandom.ai/api/operations/checkAdcvd.md): `GET /v1/adcvd/check` — Apply AD/CVD orders to a shipment - [searchAdcvdOrders](https://docs.tandom.ai/api/operations/searchAdcvdOrders.md): `GET /v1/adcvd/orders` — Search the AD/CVD order catalog - [getAdcvdOrder](https://docs.tandom.ai/api/operations/getAdcvdOrder.md): `GET /v1/adcvd/orders/{caseNumber}` — Single order detail (closed beta) - [generateAdcvdReport](https://docs.tandom.ai/api/operations/generateAdcvdReport.md): `POST /v1/adcvd/report` — Full case-by-case AD/CVD analysis - [getAdcvdRateAtDate](https://docs.tandom.ai/api/operations/getAdcvdRateAtDate.md): `GET /v1/adcvd/rates-at` — Point-in-time rate query - [searchScopeRulings](https://docs.tandom.ai/api/operations/searchScopeRulings.md): `GET /v1/adcvd/scope-rulings` — Search Commerce scope rulings (closed beta) - [searchCitDecisions](https://docs.tandom.ai/api/operations/searchCitDecisions.md): `GET /v1/adcvd/cit-decisions` — Court of International Trade decisions (closed beta) - [getAdcvdLifecycle](https://docs.tandom.ai/api/operations/getAdcvdLifecycle.md): `GET /v1/adcvd/lifecycle` — Event timeline for one case (closed beta) - [getSunsetCalendar](https://docs.tandom.ai/api/operations/getSunsetCalendar.md): `GET /v1/adcvd/sunset-calendar` — Upcoming sunset reviews (closed beta) - [getCircumventionInquiries](https://docs.tandom.ai/api/operations/getCircumventionInquiries.md): `GET /v1/adcvd/circumvention-inquiries` — Open circumvention inquiries (closed beta) - [getAdcvdReportPdf](https://docs.tandom.ai/api/operations/getAdcvdReportPdf.md): `GET /v1/adcvd-reports/{id}/pdf` — Download a saved scope-determination PDF ## HTS Reference - [searchHts](https://docs.tandom.ai/api/operations/searchHts.md): `GET /v1/hts/search` — Full-text HTS search - [getHtsNotes](https://docs.tandom.ai/api/operations/getHtsNotes.md): `GET /v1/hts/notes` — Section / chapter / subheading notes - [browseHts](https://docs.tandom.ai/api/operations/browseHts.md): `GET /v1/hts/browse` — Enumerate HTS codes by chapter or parent prefix - [getHtsHierarchy](https://docs.tandom.ai/api/operations/getHtsHierarchy.md): `GET /v1/hts/hierarchy` — Walk parents / children for one code - [expandS301](https://docs.tandom.ai/api/operations/expandS301.md): `POST /v1/hts/expand-s301` — Section 301 list expansion (admin / pipeline) - [expandCh99Scope](https://docs.tandom.ai/api/operations/expandCh99Scope.md): `POST /v1/hts/expand-ch99-scope` — Chapter 99 scope expansion (admin / pipeline) ## Trade Programs - [checkPga](https://docs.tandom.ai/api/operations/checkPga.md): `GET /v1/pga/check` — Partner Government Agency flags for an HTS code - [getChapter99Applicable](https://docs.tandom.ai/api/operations/getChapter99Applicable.md): `GET /v1/chapter99/applicable` — Chapter 99 applicable tariffs for an HTS code + country - [checkTradeProgramEligibility](https://docs.tandom.ai/api/operations/checkTradeProgramEligibility.md): `GET /v1/trade-programs/eligibility` — SPI / FTA / GSP eligibility (closed beta) - [getTariffEvents](https://docs.tandom.ai/api/operations/getTariffEvents.md): `GET /v1/tariff-events` — Stream of FR / CSMS / EO / Proclamation events (closed beta) ## Catalog - [searchCatalog](https://docs.tandom.ai/api/operations/searchCatalog.md): `GET /v1/catalog/search` — Full-text catalog search - [listCatalogSections](https://docs.tandom.ai/api/operations/listCatalogSections.md): `GET /v1/catalog/sections` — List HTS sections + their chapters - [getCatalogChapter](https://docs.tandom.ai/api/operations/getCatalogChapter.md): `GET /v1/catalog/chapters/{chapter}` — List codes in one chapter - [getCatalogCode](https://docs.tandom.ai/api/operations/getCatalogCode.md): `GET /v1/catalog/codes/{code}` — Full detail for one HTS code ## Regulatory Data - [getRegulatoryDataStatus](https://docs.tandom.ai/api/operations/getRegulatoryDataStatus.md): `GET /v1/regulatory-data/status` — Dataset freshness signals - [getUsageSummary](https://docs.tandom.ai/api/operations/getUsageSummary.md): `GET /v1/usage` — Account-scoped usage + AI spend rollup (last 30 days) ## Agent Interface - [getMcpInfo](https://docs.tandom.ai/api/operations/getMcpInfo.md): `GET /v1/mcp` — MCP server info + tool catalog - [callMcp](https://docs.tandom.ai/api/operations/callMcp.md): `POST /v1/mcp` — JSON-RPC 2.0 entry point ## Classification - [classify](https://docs.tandom.ai/api/operations/classify.md): `POST /v1/classify` — Description → 10-digit HTS code with reasoning (closed beta) - [classifyChat](https://docs.tandom.ai/api/operations/classifyChat.md): `POST /v1/classify/chat` — Conversational refinement of a classification (closed beta) - [confirmClassification](https://docs.tandom.ai/api/operations/confirmClassification.md): `POST /v1/classify/confirm` — Broker override / audit trail (closed beta) - [classifyBatch](https://docs.tandom.ai/api/operations/classifyBatch.md): `POST /v1/classify/batch` — Bulk classify (closed beta) - [classifyReport](https://docs.tandom.ai/api/operations/classifyReport.md): `POST /v1/classify/report` — Full single-product report — HTS + PGA + duty + share link (closed beta) - [searchCrossRulings](https://docs.tandom.ai/api/operations/searchCrossRulings.md): `GET /v1/rulings/cross` — CBP CROSS ruling search (closed beta) - [getCrossRuling](https://docs.tandom.ai/api/operations/getCrossRuling.md): `GET /v1/rulings/cross/{id}` — Single CROSS ruling detail (closed beta) ## Documents - [extractAuto](https://docs.tandom.ai/api/operations/extractAuto.md): `POST /v1/extract/auto` — Auto-detect document type + extract (closed beta) - [extractInvoice](https://docs.tandom.ai/api/operations/extractInvoice.md): `POST /v1/extract/invoice` — Commercial invoice → structured (closed beta) ## Account - [exportAccountData](https://docs.tandom.ai/api/operations/exportAccountData.md): `GET /v1/account/export` — Export your account data (GDPR Article 15)