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.euDownload the public OpenAPI contract
Versioning
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 processes complex classifications without blocking your application. Use a 12-minute client deadline for operational and 18 minutes for legal_deep.
Main endpoints
EU and China customs classification
| 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 |
/v1/classify-china/jobs | POST | Create a China GACC10/CIQ13 classification job |
/v1/classify-china/jobs/{id} | GET | Get China job status and result |
/v1/classify-china/batch | POST | Create a China classification batch |
/v1/classify-china/batch/{id} | GET | Get China batch status and results |
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
- EU and China classification - Connect and retrieve your first result
- 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 on