Banner

Tracktry API

Trackings 

Manage your trackings

URI Method Description
POST /trackings/post POST Create a tracking item
GET /trackings/{carrier_code}/{tracking_number} GET Get tracking results of a single tracking.
PUT /trackings/{carrier_code}/{tracking_number} PUT Update Tracking item
DELETE /trackings/{carrier_code}/{tracking_number} DELETE Delete a tracking item
POST /trackings/batch POST Create multiple trackings.
GET /trackings/get GET List all trackings
POST /trackings/realtime POST Get realtime tracking results of a single tracking

List all trackings

https://api.tracktry.com/v1/trackings/get

Request E.g.

E.g.

http://api.tracktry.com/v1/trackings/get?page=1&limit=25&created_at_min=1441314361&created_at_max=1446949161&lang=en

Headers

  • Content-Type: application/json
    Tracktry-Api-Key: YOUR_API_KEY

  • Tips

    GET /trackings/get API interface concurrency limit 1 times/s.

Parameters

ParamDescriptionDefault value
page (optional)Page to display1
limit (optional)Items per page (max 2000)100
status (optional)Items in this status null
created_at_min (optional)Start date and time of trackings created(format:The unix timestamp example:1076599161)null
created_at_max (optional)End date and time of trackings created.(format:The unix timestamp example:1076570361)now
update_time_min (optional)Start date and time of trackings updated(format:The unix timestamp example:1076599161)null
update_time_max (optional)End date and time of trackings updated.(format:The unix timestamp example:1076570361)now
order_created_time_min (optional)Start date and time of trackings created(format:The unix timestamp example:1076599161)null
order_created_time_max (optional)End date and time of trackings created.(format:The unix timestamp example:1076570361)now
lang (optional)Return to language type (only when courier official website supports). null
numbers (optional)Track number (max 40) ,multiple numbers must be separated by .(Example:numbers=LX123445678CN,LX456789123CN)null
orders (optional)Order number (max 40) ,multiple orders must be separated by .(Example:orders=1234456,456789)null
archived (optional)String true Get archive number, string false Get undocumented number, other string value or null Get mixed number.null

  • Response Body 200

    {

    "meta": {
        "code": 200,
        "type": "Success",
        "message": "Success"
    },
    "data": {
        "page": 1,
        "limit": 25,
        "total": "56",
        "items": [
         {
            "id": "009e9a8a6450cb5ce4b53ac75674fe78",
            "tracking_number": "RR050349575PH",
            "carrier_code": "phlpost",
            "status": "delivered",
            "created_at": "2015-10-30T11:35:16+08:00",
            "updated_at": "2015-11-03T13:47:20+08:00",
            "order_create_time": "2017-08-26 16:48",
            "title": null,
            "order_id": null,
            "customer_name": null,
            "customer_email": null,
            "archived": false,
            "original_country": "Philippines",
            "destination_country": "United States",
            "itemTimeLength": 12,
            "service_code": null,
            "origin_info": {
                "weblink": "http:\/\/www.phlpost.gov.ph\/",
                "phone": "+ (63) 854-9825",
                "carrier_code": "phlpost",
                "trackinfo": [{
                    "Date": "2015-10-25 15:01",
                    "StatusDescription": "Receive at country of destination",
                    "Details": "United States of America (the)"
                }, {
                    "Date": "2015-10-22 16:35",
                    "StatusDescription": "Prepare dispatch to destination country",
                    "Details": "PHILIPPINES"
                },
                ...
            },
            "destination_info": {
                "weblink": "http:\/\/www.usps.com\/",
                "phone": "1-800-275-8777",
                "carrier_code": "usps",
                "trackinfo": [{
                    "Date": "2015-11-02 17:11",
                    "StatusDescription": "Delivered",
                    "Details": "RENTON, WA 98056"
                }, {
                    "Date": "2015-11-02 08:07",
                    "StatusDescription": "Arrived at Unit",
                    "Details": "RENTON, WA 98059"
                }]
            }
		"lastEvent": "Delivered,RENTON, WA 98056,2015-11-02 17:11",
		"lastUpdateTime": "2015-11-02 17:11"
        },
        {
            "id": "e1e4baddad2b782d3aa3f6c75277ea22",
            "tracking_number": "RN210552627LT",
            "carrier_code": "lietuvos-pastas",
            "status": "transit",
            "created_at": "2015-10-30T10:52:41+08:00",
            "updated_at": "2015-11-03T13:47:23+08:00",
            "order_create_time": "2017-08-26 16:48",
            "title": null,
            "order_id": null,
            "customer_name": null,
            "customer_email": null,
            "original_country": "Lithuania",
            "destination_country": "Korea, South",
            "itemTimeLength": null,
            "origin_info": {
                "weblink": "http:\/\/www.post.lt\/",
                "phone": "(370) 8 700 55400",
                "carrier_code": "lietuvos-pastas",
                "trackinfo": [{
                    "Date": "2015-10-29 17:26",
                    "StatusDescription": "Departure from outward office of exchange",
                    "Details": "HK AMC"
                }]
            },
            "destination_info": {
                "weblink": "http:\/\/www.epost.go.kr\/",
                "phone": "82-2-2108-9895",
                "carrier_code": "korea-post",
                "trackinfo": [{
                    "Date": "2015-10-29 17:26",
                    "StatusDescription": "Departure from outward office of exchange",
                    "Details": "HKHKGA,Dispatch number : KRSELB"
                }]
            }
		"lastEvent": "Departure from outward office of exchange,HKHKGA,Dispatch number : KRSELB,2015-10-29 17:26",
		"lastUpdateTime": "2015-10-29 17:26"
        },
        ...
        ]
    }
}