Skip to main content
The Traddal REST API provides endpoints for customs duty calculations, AI-powered HS classification, and order management. Classification endpoints support mini, pro, and max modes via the optional mode request field.

​
Base URLs

​
Authentication

All endpoints require a Bearer token obtained via OAuth2 client credentials. See Authentication for details.

​
Endpoints

Classification

Classify products to HS/HTS codes using AI-powered search.

Duty Calculation

Calculate customs duties, taxes, and fees for international shipments.

Orders

Create and manage orders with automatic duty calculation.

Webhooks

Receive real-time notifications for payment and order events.

​
Response format

All responses are returned in JSON format. Successful responses return 2xx status codes. Error responses include a message describing the issue.

​
Rate limits

API requests are rate limited. If you exceed the limit, you’ll receive a 429 Too Many Requests response. Contact support if you need higher limits.