API key

In order to use this API, you need to generate a TrackingMore API key in the API Keys.Apply for free use of API.

The base URL

http://api.trackingmore.com/v2

Header

In order to verify and authenticate your application (e.g. your site), all of the requests that you make to the API must include your unique TrackingMore API Key header (Trackingmore-Api-Key), which you can generate and/or find in the TrackingMore Panel.

Content-Type: application/json
Trackingmore-Api-Key: YOUR_API_KEY

List of Tracking Statuses

StringDescription
pendingNew shipments added that are pending to track
notfoundItem is not found at this moment.
transitItem has shipped from originating and is en route to its destination
pickupItem is out for delivery or arrived at local facility, you may schedule for delivery or pickup
deliveredThe shipment was delivered sucessfully.
undeliveredCarrier attempted to deliver but failed, and usually leaves a notice and will try to delivery again.
exceptionItem might undergo unusual shipping condition, this may due to several reasons, most likely item was returned to sender, customs issue, lost, damaged etc.
expiredItem was in transportation period for a long time still has no delivered results.

Typical Server Responses

We will respond with one of the following status codes.

CodeDescription
200OK - The request was successful (some API calls may return 201 instead).
201Created - The request was successful and a resource was created.
202Created - The request was successful but exceeding the limit.
401Unauthorized - Authentication failed or user does not have permissions for the requested operation.
4001Unauthorized - Invalid API key.
4002Unauthorized - API key has been deleted.
4012Bad Request - The request could not be understood or was missing required parameters.
4013Bad Request - Tracking_number is required.
4014Bad Request - The value of `tracking_number` is invalid.
4015Bad Request - The value of `carrier_code` is invalid.
4016Bad Request - Tracking already exists.
4017Bad Request - Tracking does not exist.
4018Bad Request - Due to overload risks this feature requires custom activation. Contact [email protected] for more information.
4020Bad Request - Up to 200 at a time
4021Bad Request - Your remaining balance is not enough, so you can not call the API request data.
4031No Content - The request was successful but the response is empty.
4032No Content - Cannot detect courier.
402Payment Required - Payment required.
403Forbidden - Access denied.
404Not Found - Resource was not found.
405Method Not Allowed - Requested method is not supported for the specified resource.
409Conflict - The request could not be completed due to a conflict.
429Too Many Requests - Exceeded API limits. Pause requests, wait two minute, and try again.
500Server error
503Service Unavailable - The service is temporary unavailable (e.g. scheduled Platform Maintenance). Try again later.

Request Rate Limiting

We do have a small amount of rate limit. Please be aware that if you exceed these limits, you will receive a 429 error prompt..

  • Real-time tracking: each IP, maximum 3 requests per second.

  • List all trackings; each IP, maximum 1 request with up to 200 trackings per second.

Multilingual content for API call

list of couriers supporting multilingual content for API call.

courier code courier name
139express 139 ECONOMIC Package
17postservice 17 Post Service
acscourier ACS Courier
adicional Adicional Logistics
aramex Aramex
armenia-post Armenia post
asendia-de Asendia Germany
austria-post Austrian Post
azerbaijan-post Azerbaijan post
bartolini BRT Bartolini
belgium-post Belgium post
belpochta Belarus post
bosnia-and-herzegovina-post Bosnia and Herzegovina post
brazil-correios Brazil Correios
canada-post Canada post
canpar Canpar Courier
china-ems China EMS
chronopost France EMS - Chronopost
cnexps CNE Express
colissimo French Post - Colissimo
correo-argentino Argentina post
correos-bolivia Bolivia post
correos-spain correos
ctt Portugal post - CTT
czech-post Česká Pošta
denmark-post Denmark post
dhl DHL
dhl-active DHL Active Tracing
dhl-es DHL Spain Domestic
dhl-germany Deutsche Post DHL
dhl-poland DHL Poland Domestic
dhlglobalmail DHL eCommerce
dhlparcel-nl DHL Parcel Netherlands
dpd DPD
ecargo-asia Ecargo
emirates-post Emirates Post
fedex Fedex
finland-posti Finland post - Posti
georgian-post Georgia post
gls GLS
gls-italy GLS Italy
greece-post ELTA Hellenic Post
hong-kong-post Hong Kong Post
iceland-post Iceland post
israel-post Israel post
israel-post Israel post
japan-post Japan post
jcex JCEX
kazpost Kazakhstan post
kerry-logistics Kerry Express
korea-post Korea Post
kyrgyzpost Kyrgyzstan post
latvijas-pasts Latvia post
lietuvos-pastas Lithuania post
luxembourg-post Luxembourg post
macao-post Macao Post
malaysia-post Malaysia post
matkahuolto Matkahuolto
moldova-post Moldova post
omniva Estonia post
pfcexpress PFC Express
poczta-polska Poland post
posten-norge Posten Norge
purolator Purolator
saudi-post Saudi Post
serbia-post Serbia post
sf-express S.F Express
sfb2c S.F International
sfcservice SFC Service
sfcservice SFC Service
slovakia-post Slovakia post
sweden-posten Sweden Posten
swiss-post Swiss Post
taqbin-jp Yamato Japan
taxydromiki Geniki Taxydromiki
tnt TNT
tunisia-post Tunisia post
turkey-post Turkey post
ups UPS
vietnam-post Vietnam post
wishpost WishPost
yanwen YANWEN