Documentation

TariffGuard API

Welcome to the TariffGuard AI API documentation. Our RESTful API allows you to integrate autonomous customs compliance checking directly into your ERP, WMS, or eCommerce checkout flows.

Developer Friendly

Simple REST endpoints with predictable JSON responses. Standard HTTP codes.

Asynchronous Engine

Non-blocking background processing via webhooks or simple status polling.

Authentication

Authenticate your API requests by including your API key in the Authorization header of every request.

Authorization: Bearer tg_live_xxxxxxxxxxxxxxxxx

Create an Audit

POST

/api/v1/audit

Initiates a new background audit process for a given product and shipment scenario.

Request Body

{
  "product_name": "Industrial Servo Motor",
  "technical_description": "24V DC motor, 5000 RPM, stainless steel casing",
  "material_composition": "Steel, Copper, Neodymium",
  "intended_use": "Manufacturing automation robotics",
  "origin_country": "US",
  "destination_country": "DE",
  "shipment_value": 25000
}

Response (202 Accepted)

{
  "audit_id": "aud_8f92j2k1m",
  "status": "processing",
  "message": "Audit dispatched to CrewAI cluster."
}