Introduction
Overview of The Trade Hub API - automated customs classification and dual-use goods export control.
The Trade Hub API lets you integrate automated customs classification and dual-use goods export control directly into your systems.
Base URL
All requests are sent to:
https://api.thetradehub.euVersioning
The API is versioned via the URL path. The current version is v1:
https://api.thetradehub.eu/v1/...Breaking changes will result in a new major version. Adding new fields to responses is considered backward-compatible.
Data format
- All requests and responses use JSON format.
- The
Content-Type: application/jsonheader must be included in all requests with a body. - Dates follow the ISO 8601 format (
2026-02-24T10:30:00Z). - Identifiers are UUID v4.
Asynchronous pattern (jobs)
Classification operations use an asynchronous job-based pattern:
- Create a job - Send a
POSTrequest to start processing. You immediately receive a job identifier. - Poll for status - Make
GETrequests with the identifier to track progress. - Retrieve results - When the status changes to
completed, the response contains the full results.
POST /v1/classify/jobs → { "id": "...", "status": "pending" }
GET /v1/classify/jobs/{id} → { "id": "...", "status": "completed", "result": { ... } }This pattern allows complex classifications to be processed without blocking your application. Average processing time is 3 to 8 seconds.
Main endpoints
Customs classification (ClassifyAI)
| Endpoint | Method | Description |
|---|---|---|
/v1/classify/jobs | POST | Create a classification job |
/v1/classify/jobs/{id} | GET | Get job status and results |
/v1/classify/batch | POST | Batch classification (up to 1,000 items) |
/v1/classify/batch/{id} | GET | Batch classification status |
/v1/classify/history | GET | Classification history |
/v1/classify/history/{id} | GET | Single classification detail |
Export Control
| Endpoint | Method | Description |
|---|---|---|
/v1/export-control/chat | POST | Dual-use goods SSE streaming classification |
/v1/export-control/jobs | POST | Async export control classification job |
/v1/export-control/jobs/{id} | GET | Export control job status |
/v1/export-control/sessions | GET | List classification sessions |
/v1/export-control/sessions/{id} | GET | Session detail |
/v1/export-control/quota | GET | Check remaining quota |
Next steps
- Authentication - Set up your API key
- Classification - Classify your first product
- Batch classification - Process multiple products at once
- Export Control - Classify dual-use goods
- Rate limiting - Understand rate limits
- Error handling - Understand error codes
Last updated