API
Developers
LandedGrid’s calculation engine is API-first. The endpoints that power the site, their request and response shapes, and the status of the public API.
Updated 2026-09-22
The web calculator is a client of the same domain services that a public API will expose. The endpoints exist today behind the site, rate-limited and without authentication, and are not yet offered for third-party use: request shapes may change until the public API is announced.
Endpoints
POST /api/calculate— a calculation request (destination, origin, tariff code, date, valuation inputs, quantities, preference and trade-remedy facts, user costs) returns scenarios, result lines with explanations, statuses, information needed and an audit trail.POST /api/compare— two to five supplier requests for one destination; returns per-supplier results and a ranked comparison, ranking only when every option has a verified total.POST /api/classify— free text plus a path of chosen nodes; returns candidate headings, the next question and the classification status.GET /api/search?jurisdiction=US&q=…— nomenclature search.GET /api/sourcesandGET /api/health— the data status and certification tables as JSON.
Principles that will carry into the public API
- Amounts and rates are decimal strings. Nothing is rounded in transit.
- Unresolved components are explicit objects, never zero or null-as-zero.
- Every response is reproducible from its audit trail and the archived dataset versions.
If you want to be told when the public API opens, write to hello@landedgrid.com.