# LandedFees API

## Docs

- [Introduction](https://docs.landedfees.com/introduction.md): REST API for landed-cost calculation, HS classification, and multi-origin comparison. Same engine that powers the LandedFees UI, exposed as JSON.
- [Quickstart](https://docs.landedfees.com/quickstart.md): Sign up, mint an API key, and run your first landed-cost calculation in under five minutes.
- [Authentication](https://docs.landedfees.com/authentication.md): Bearer API keys, format, rotation, revocation, and per-tier limits.
- [Tariff stacking](https://docs.landedfees.com/concepts/tariff-stacking.md): How Section 232, 301, IEEPA, Section 122, and Chapter 99 overlays combine on a single line item.
- [HS classification](https://docs.landedfees.com/concepts/hs-classification.md): How the classifier picks an HS or HTS code from a product description, using vector retrieval, 3-sample voting, adversarial verification, and CROSS ruling anchoring.
- [Cost layers](https://docs.landedfees.com/concepts/cost-layers.md): The CostLayer[] shape, statutory fees (HMF, MPF, broker, ISF, exam expected value), and why each layer stays separate.
- [Provenance](https://docs.landedfees.com/concepts/provenance.md): Every rate carries a source URL and legal citation. How to read them, and why WITS anchors the non-US non-EU tail.
- [API Reference](https://docs.landedfees.com/api-reference/introduction.md): Five stable v1 endpoints. Bearer-key auth. JSON in, JSON out. Rate limit 60 requests per minute per key.
- [Calculate landed cost](https://docs.landedfees.com/api-reference/endpoint/calc.md): Runs the landed-cost engine end-to-end for a single shipment. Resolves MFN, Section 232 / 301 / 122 / 338, AD/CVD, FTA preferences, VAT/GST, MPF, HMF, and de-minimis. Returns a full CalculationResult plus compliance flags (PGA, restricted product, denied party, unit-price deviation, data-freshness,…
- [Bulk landed cost](https://docs.landedfees.com/api-reference/endpoint/calc-bulk.md): Accepts up to 500 single-line rows sharing ship-level fields (destination, currency, incoterm, transport_mode, freight, insurance). Freight and insurance are pro-rated across rows by line value. Row-level validation errors do not fail the batch; they are returned in the `errors` array alongside succ…
- [Classify to HS or HTS](https://docs.landedfees.com/api-reference/endpoint/classify.md): Accepts either a single description or a batch of up to 50 lines. Returns the recommended 6-digit HS code, a 10-digit HTS suggestion when available, and a confidence score. Optional `hs_code_printed` lets you pass the code your supplier printed on the commercial invoice; the classifier compares it a…
- [Compare origins](https://docs.landedfees.com/api-reference/endpoint/compare.md): Runs the landed-cost engine in parallel for 1 to 6 origin countries against a single HS + destination + value + freight combination. Returns a compact per-origin breakdown (MFN, Section 122 / 301 / 301-FL / 232 / 338, AD/CVD, MPF, HMF, VAT) plus flags (denied-party, PGA, restriction, AD/CVD, fta_opp…
- [Look up rates](https://docs.landedfees.com/api-reference/endpoint/rates.md): Returns the resolved MFN rate plus every applicable overlay (Section 232 / 301 / 122 / 301-FL / 338, AD/CVD, preferential FTA rates by program) and destination-country VAT / GST. Read-only, cacheable for 1 hour.
- [Bulk CSV upload](https://docs.landedfees.com/guides/bulk-csv-upload.md): Pipe a purchase order or shipment manifest through /v1/calc/bulk. Format, error handling, and tier requirements.
- [Webhook events](https://docs.landedfees.com/guides/webhook-events.md): Planned event catalog, signature verification, retry policy, and replay window. Preview only until Phase 2 ships.
- [Error handling](https://docs.landedfees.com/guides/error-handling.md): Patterns for handling 400, 402, 422, 429, and 500 responses in production callers.
- [Working with rate limits](https://docs.landedfees.com/guides/rate-limits.md): Practical patterns for staying under 60 requests per minute per key.
- [Errors](https://docs.landedfees.com/errors.md): HTTP status codes, error envelope shape, and common failure modes with fixes.
- [Rate limits](https://docs.landedfees.com/rate-limits.md): 60 requests per minute per key, 429 response shape, retry semantics, and tier upgrade paths.
- [Python SDK](https://docs.landedfees.com/sdks/python.md): Install, configure, and call every LandedFees v1 endpoint from Python 3.9+.
- [TypeScript SDK](https://docs.landedfees.com/sdks/typescript.md): Install, configure, and call every LandedFees v1 endpoint from Node 18+, Bun, Deno, or the browser (server-only).
- [Playground](https://docs.landedfees.com/playground.md): The live in-browser playground for the LandedFees API.

## OpenAPI Specs

- [openapi](https://docs.landedfees.com/api-reference/openapi.yaml)

## Optional

- [GitHub](https://github.com/landedfees)
- [Support](mailto:info@growyourbrand.io)