REST API v3

API Reference

Complete reference for ETrackings REST API — track parcels, list couriers, send notifications and receive webhooks. All endpoints require HTTPS.

https://api.etrackings.com/api/v3
Getting Started
1
Create an ETrackings account
Sign up free or Log in to your existing account
2
Get API Key & Key Secret
Settings › API Keys — Go to Settings › API Keys to get credentials for sending requests
3
Make your first API request
Add the required headers and call the endpoint. See the example below.
Authentication

Every request must include both of these HTTP headers:

Etrackings-Api-Key
API Key from Settings › API Keys
Etrackings-Key-Secret
Key Secret from Settings › API Keys
Accept-Language
Language for returned data — th or en
Etrackings-Api-Key: YOUR_API_KEY Etrackings-Key-Secret: YOUR_KEY_SECRET Accept-Language: th Content-Type: application/json
Quick Start — Track a parcel

POST /tracks/find — POST with courier and trackingNo

curl --request POST \ 'https://api.etrackings.com/api/v3/tracks/find' \ --header 'Etrackings-Api-Key: YOUR_API_KEY' \ --header 'Etrackings-Key-Secret: YOUR_KEY_SECRET' \ --header 'Accept-Language: th' \ --header 'Content-Type: application/json' \ --data-raw '{"courier":"kex-express","trackingNo":"SHP5054369172"}'
Response
{ "meta": { "code": 200, "message": "OK" }, "data": { "trackingNo": "SHP5054369172", "courier": "เคอรี่ เอ็กซ์เพรส", "courierKey": "kex-express", "status": "ON_DELIVERED", "timelines": [...] } }
Response Format

All responses are JSON. A meta object contains the HTTP status code and a data object contains the payload.

Success — 2xx
{ "meta": { "code": 200, "message": "OK" }, "data": {...} }
Error — 4xx / 5xx
{ "meta": { "code": 401, "message": "Invalid API key." } }
What's Next
Delivery Statuses
All status codes — ON_DELIVERED, ON_SHIPPING, etc.
Error Codes
401, 404, 429, 500 — meanings and how to handle
Supported Couriers
All supported couriers with keys and images