# 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)

## 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
- [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

## 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

## 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

## 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

## 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