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

Create an ETrackings account

Get API Key & Key Secret

Settings › API Keys — Go to Settings › API Keys to get credentials for sending requests

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 with courier and trackingNo

Terminal

curl -X GET \
  https://api.etrackings.com/api/v3/couriers \
  -H 'Etrackings-api-key: YOUR_API_KEY' \
  -H 'Etrackings-key-secret: YOUR_SECRET'

curl -X POST \
  https://api.etrackings.com/api/v3/tracks/find \
  -H 'Content-Type: application/json' \
  -H 'Etrackings-api-key: YOUR_API_KEY' \
  -H 'Etrackings-key-secret: YOUR_SECRET' \
  -d '{
    "courier": "thailand-post",
    "trackingNo": "EY123456789TH"
  }'

curl -X POST \
  https://api.etrackings.com/api/v3/send-track \
  -H 'Content-Type: application/json' \
  -H 'Etrackings-api-key: YOUR_API_KEY' \
  -H 'Etrackings-key-secret: YOUR_SECRET' \
  -d '{
    "courier": "kex-express",
    "trackingNo": "SHP5054369172",
    "callbackUrl": "https://your-site.com/webhook"
  }'

API Endpoints

Couriers

GET /couriers

List supported couriers, detect courier from tracking number

Trackings

POST /tracks/find

Track parcels by tracking number and courier. Supports all couriers.

Send Track

POST /send-track

Send parcel status notifications to recipients via phone number

Webhooks

POST callback_url

Receive real-time events when parcel status changes

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." } }

See all Error Codes

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

On This Page

Base URL

            https://api.etrackings.com/api/v3
          

Status Codes

200 OK

201 Created

401 Unauthorized

404 Not Found

429 Rate Limited

500 Server Error

Get API Key

API Reference

Consent to Personal Data

Privacy Preferences