Ship from Thailand with our REST API
Use the Thai Nexus API to build integrations with any platform. Get shipping quotes, create shipments, and track packages programmatically with a single API token.
What you can build
The same rate engine and shipment pipeline that powers the Thai Nexus dashboard, exposed as clean REST endpoints.
Live rate engine
One call returns prices from every active courier, already including fuel surcharge, oversize fees, and VAT.
Worldwide coverage
Quote and ship from Thailand to destinations worldwide using ISO codes or full country names.
Full shipment lifecycle
Create, read, list, update, and cancel shipments programmatically, and read tracking status back at any time.
Token authentication
Every request is authenticated with your personal tnx_ token, sent as a bearer header or in the request body.
Built for speed
JSON in, JSON out, with CORS enabled and the service list cached for 24 hours on our side.
Any language
Plain REST over HTTPS, so it works with cURL, JavaScript, PHP, Python, or whatever your stack runs on.
Getting started
One base URL, one token, and you are ready to make your first call.
Base URL
Every endpoint lives under one base URL. Append the endpoint name to it.
https://app.thainexus.co.th/functions
All responses are JSON and include a success flag. Errors return the same shape with an error message and an HTTP status of 400, 401, or 500.
Authentication
Requests are authenticated with your personal API token, which starts with tnx_. Generate it in Profile Settings inside your Thai Nexus dashboard.
// Option 1 - Authorization header
Authorization: Bearer tnx_xxxxxxxxxxxxxxxxxxxx
// Option 2 - request body
{ "api_token": "tnx_xxxxxxxxxxxxxxxxxxxx" }Four steps to your first shipment
From account creation to a tracked parcel on its way out of Thailand.
Create your account
Register a free Thai Nexus account. No credit card is needed to start testing the API.
Generate your API token
Open Profile Settings in your dashboard and generate your personal tnx_ token. You can revoke and regenerate it at any time.
Get a quote
Call apiQuote with a destination country and package dimensions to see live prices from every active courier.
Create and track
Send the shipment with shipmentCrud, then poll the same endpoint for status and tracking updates until delivery.
UAT (test) environment
Build and verify your integration on UAT before switching to production.
Use the UAT host to build and verify integrations before switching to production. Request and response shapes match production for quotation, shipping services, and shipment CRUD. Tracking events and the Tracking API are production-only; there is no UAT for tracking.
UAT base URL: https://uat-dev.thainexus.co.th/functions
Same function paths as production (apiQuote, apiShippingServices, shipmentCrud). Example:
https://uat-dev.thainexus.co.th/functions/apiQuotehttps://uat-dev.thainexus.co.th/functions/shipmentCrudhttps://uat-dev.thainexus.co.th/functions/apiShippingServicesHow to get a UAT API key
Request a UAT API key
UAT keys are not self-serve. Email contact@thainexus.co.th (or contact your Thai Nexus account manager) and ask for a UAT API key. Keys use the format uat_tnx_... and only work on the UAT host.
Call the UAT base URL
Send the same paths as production, but against https://uat-dev.thainexus.co.th/functions. Do not use a production tnx_... token on UAT, and do not use a uat_tnx_... token on production.
Authenticate UAT requests
Send Authorization: Bearer uat_tnx_... or include api_token in the JSON body. shipmentCrud always expects api_token in the body.
Example UAT quote request
curl -X POST https://uat-dev.thainexus.co.th/functions/apiQuote \
-H "Content-Type: application/json" \
-d '{
"api_token": "uat_tnx_XXXXXXXX_XXXXXXXX_XXXXXXXX",
"country": "US",
"actual_weight_kg": 2.5,
"length_cm": 30,
"width_cm": 20,
"height_cm": 15,
"is_document": false,
"platform": "wix"
}'- Supported on UAT: apiQuote, apiShippingServices, and shipmentCrud.
- shipmentCrud on UAT is a sandbox. Creates, updates, and deletes stay on UAT and do not write to production shipments.
- There is no UAT for tracking events or the Tracking API. Use public tracking or request production Tracking API access.
- When your integration is ready, switch the base URL to production and use your Profile Settings tnx_... token.
Need a key? Email contact@thainexus.co.th with subject "UAT API key request".
API Endpoints
Tap any endpoint to see a full request and response example.
Start building today
Create a free Thai Nexus account, generate your API token, and make your first quote request in minutes.