Skip to content
LandedGrid
Menu

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/sources and GET /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.