Home

Introduction

Parcel Tracking API

version 1

Parcel Tracking allows you to determine the real-time location and status of your parcels worldwide. To track the parcel’s status and movement, simply enter the tracking number provided by the courier service.

OpenAPI Specification

Start designing your API in minutes. The OpenAPI specification file enables you to learn and interact with API elements, including all available endpoints, input and output representations.

General information

Parcel Tracking API is organized around REST.
Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API endpoint#

1https://tracking.searates.com

All endpoints are only accessible via HTTPS and are located at tracking.searates.com

Tracking by tracking number

get/parcel

Getting tracking information by tracking number.

Headers

Content-Typeapplication/json

Query Parameters
  • api_keyREQUIREDstring

    Your api key. If you do not have an api key - contact us to purchase a subscription.

  • numberREQUIREDstring

    Tracking number

    Examples:AENM0021834400

  • carrier_codeOptionalstring

    Carrier code - see Available carriers

    Examples:CNAO

  • pathOptionalboolean

    This parameter determines whether to output the route in the response

    Default:false

Response example
1{
2  "success": true,
3  "status_code": "OK",
4  "metadata": {
5    "request_parameters": {
6      "number": "AENM0021834400",
7      "carrier_code": "CNAO"
8    },
9    "updated_at": "2024-10-16 08:07:49",
10    "parcel_company": {
11      "name": "Cainiao",
12      "url": "https://www.cainiao.com/",
13      "carrier_code": "CNAO"
14    }
15  },
16  "data": {
17    "status": "DELIVERED",
18    "from": {
19      "name": "China",
20      "state": null,
21      "country": "China",
22      "country_code": "CN",
23      "locode": null,
24      "lat": 35.86166,
25      "lng": 104.195397,
26      "timezone": null
27    },
28    "to": {
29      "name": "Ukraine",
30      "state": null,
31      "country": "Ukraine",
32      "country_code": "UA",
33      "locode": null,
34      "lat": 48.379433,
35      "lng": 31.16558,
36      "timezone": null
37    },
38    "departure_datetime": {
39      "estimated": null,
40      "actual": "2024-07-29 18:01:59"
41    },
42    "arrival_datetime": {
43      "estimated": null,
44      "actual": "2024-08-10 08:47:55"
45    },
46    "events": [
47      {
48        "order_id": 1,
49        "event_code": null,
50        "description": "Shipment information received by warehouse electronically",
51        "datetime": {
52          "estimated": null,
53          "actual": "2024-07-29 00:30:35"
54        },
55        "location": null,
56        "transport_mode": null
57      },
58      {
59        "order_id": 2,
60        "event_code": null,
61        "description": "Package shipped out from warehouse",
62        "datetime": {
63          "estimated": null,
64          "actual": "2024-07-29 18:01:59"
65        },
66        "location": null,
67        "transport_mode": null
68      },
69      {
70        "order_id": 3,
71        "event_code": null,
72        "description": "Received by logistics company",
73        "datetime": {
74          "estimated": null,
75          "actual": "2024-07-30 04:15:07"
76        },
77        "location": null,
78        "transport_mode": null
79      },
80      {
81        "order_id": 4,
82        "event_code": null,
83        "description": "[Fenggang Town] Processing at sorting center",
84        "datetime": {
85          "estimated": null,
86          "actual": "2024-07-30 04:15:07"
87        },
88        "location": {
89          "name": "Fenggang",
90          "state": null,
91          "country": "China",
92          "country_code": "CN",
93          "locode": "CNFEN",
94          "lat": 22.74871,
95          "lng": 114.13719,
96          "timezone": null
97        },
98        "transport_mode": null
99      },
100      {
101        "order_id": 5,
102        "event_code": null,
103        "description": "[Fenggang Town] Departed from sorting center",
104        "datetime": {
105          "estimated": null,
106          "actual": "2024-07-30 04:38:48"
107        },
108        "location": {
109          "name": "Fenggang",
110          "state": null,
111          "country": "China",
112          "country_code": "CN",
113          "locode": "CNFEN",
114          "lat": 22.74871,
115          "lng": 114.13719,
116          "timezone": null
117        },
118        "transport_mode": null
119      },
120      {
121        "order_id": 6,
122        "event_code": null,
123        "description": "Arrived at departure transport hub",
124        "datetime": {
125          "estimated": null,
126          "actual": "2024-07-31 09:57:20"
127        },
128        "location": null,
129        "transport_mode": null
130      },
131      {
132        "order_id": 7,
133        "event_code": null,
134        "description": "Export customs clearance started",
135        "datetime": {
136          "estimated": null,
137          "actual": "2024-08-01 10:07:06"
138        },
139        "location": null,
140        "transport_mode": null
141      },
142      {
143        "order_id": 8,
144        "event_code": null,
145        "description": "Export customs clearance complete",
146        "datetime": {
147          "estimated": null,
148          "actual": "2024-08-01 12:08:25"
149        },
150        "location": null,
151        "transport_mode": null
152      },
153      {
154        "order_id": 9,
155        "event_code": null,
156        "description": "Leaving from departure country/region",
157        "datetime": {
158          "estimated": null,
159          "actual": "2024-08-02 09:38:00"
160        },
161        "location": null,
162        "transport_mode": null
163      },
164      {
165        "order_id": 10,
166        "event_code": null,
167        "description": "Departed from departure country/region",
168        "datetime": {
169          "estimated": null,
170          "actual": "2024-08-02 17:22:00"
171        },
172        "location": null,
173        "transport_mode": null
174      },
175      {
176        "order_id": 11,
177        "event_code": null,
178        "description": "Arrived at linehaul office",
179        "datetime": {
180          "estimated": null,
181          "actual": "2024-08-02 21:14:00"
182        },
183        "location": null,
184        "transport_mode": null
185      },
186      {
187        "order_id": 12,
188        "event_code": null,
189        "description": "Arrived in transit country/region",
190        "datetime": {
191          "estimated": null,
192          "actual": "2024-08-03 12:38:54"
193        },
194        "location": null,
195        "transport_mode": null
196      },
197      {
198        "order_id": 13,
199        "event_code": null,
200        "description": "Leaving transit country/region",
201        "datetime": {
202          "estimated": null,
203          "actual": "2024-08-04 18:43:05"
204        },
205        "location": null,
206        "transport_mode": null
207      },
208      {
209        "order_id": 14,
210        "event_code": null,
211        "description": "Received by local delivery company",
212        "datetime": {
213          "estimated": null,
214          "actual": "2024-08-07 12:04:07"
215        },
216        "location": null,
217        "transport_mode": null
218      },
219      {
220        "order_id": 15,
221        "event_code": null,
222        "description": "Import customs clearance started",
223        "datetime": {
224          "estimated": null,
225          "actual": "2024-08-07 12:04:17"
226        },
227        "location": null,
228        "transport_mode": null
229      },
230      {
231        "order_id": 16,
232        "event_code": null,
233        "description": "Import customs clearance complete",
234        "datetime": {
235          "estimated": null,
236          "actual": "2024-08-07 14:30:06"
237        },
238        "location": null,
239        "transport_mode": null
240      },
241      {
242        "order_id": 17,
243        "event_code": null,
244        "description": "Arrived at destination country/region sorting center",
245        "datetime": {
246          "estimated": null,
247          "actual": "2024-08-07 15:18:24"
248        },
249        "location": null,
250        "transport_mode": null
251      },
252      {
253        "order_id": 18,
254        "event_code": null,
255        "description": "Arrived at local delivery center",
256        "datetime": {
257          "estimated": null,
258          "actual": "2024-08-07 15:46:04"
259        },
260        "location": null,
261        "transport_mode": null
262      },
263      {
264        "order_id": 19,
265        "event_code": null,
266        "description": "Arrived at pick-up point. Package available for collection.",
267        "datetime": {
268          "estimated": null,
269          "actual": "2024-08-08 08:21:18"
270        },
271        "location": null,
272        "transport_mode": null
273      },
274      {
275        "order_id": 20,
276        "event_code": null,
277        "description": "Package delivered",
278        "datetime": {
279          "estimated": null,
280          "actual": "2024-08-10 08:47:55"
281        },
282        "location": null,
283        "transport_mode": null
284      }
285    ]
286  }
287}

Available carriers

get/info/parcel_companies

Information about the carriers we support worldwide for tracking parcels

Headers

Content-Typeapplication/json

Response example
1{
2  "status": "success",
3  "message": "OK",
4  "data": [
5    {
6      "name": "139Express",
7      "country_code": "CN",
8      "carrier_code": "139X",
9      "active": true,
10      "maintenance": false,
11      "url": "http://www.139express.com/"
12    },
13    {
14      "name": "1688",
15      "country_code": "CN",
16      "carrier_code": "1688",
17      "active": true,
18      "maintenance": false,
19      "url": "https://www.1688.com/"
20    },
21    {
22      "name": "17EXP",
23      "country_code": "CN",
24      "carrier_code": "17XP",
25      "active": true,
26      "maintenance": false,
27      "url": "http://www.17-exp.com/"
28    },
29    {
30      "name": "17FEIA",
31      "country_code": "CN",
32      "carrier_code": "17FE",
33      "active": true,
34      "maintenance": false,
35      "url": "http://www.17feia.com/"
36    },
37    {
38      "name": "1ST",
39      "country_code": "CN",
40      "carrier_code": "1ST5",
41      "active": true,
42      "maintenance": false,
43      "url": "http://1st56.com/group/index/"
44    },
45    {
46      "name": "1STOP",
47      "country_code": "CN",
48      "carrier_code": "1STP",
49      "active": true,
50      "maintenance": false,
51      "url": "http://www.1stop.net/"
52    },
53    {
54      "name": "1strack",
55      "country_code": "IN",
56      "carrier_code": "1STR",
57      "active": true,
58      "maintenance": false,
59      "url": "http://www.1strackcouriers.com/"
60    },
61    {
62      "name": "1TONG",
63      "country_code": "CN",
64      "carrier_code": "1TNG",
65      "active": true,
66      "maintenance": false,
67      "url": "http://www.1tongexpress.com/"
68    },
69    {
70      "name": "218 Logistics",
71      "country_code": "CN",
72      "carrier_code": "218L",
73      "active": true,
74      "maintenance": false,
75      "url": "http://www.218wl.cn/"
76    },
77    {
78      "name": "2GO",
79      "country_code": "PH",
80      "carrier_code": "2GOP",
81      "active": true,
82      "maintenance": false,
83      "url": "http://supplychain.2go.com.ph/"
84    },
85    {
86      "name": "3CLIQUES",
87      "country_code": "CN",
88      "carrier_code": "3CLQ",
89      "active": true,
90      "maintenance": false,
91      "url": "https://www.3cliques.io"
92    },
93    {
94      "name": "3DADA",
95      "country_code": "CN",
96      "carrier_code": "3DAD",
97      "active": true,
98      "maintenance": false,
99      "url": "https://www.3dada.cn/"
100    },
101    {
102      "name": "3JMS Logistics",
103      "country_code": "US",
104      "carrier_code": "3JMS",
105      "active": true,
106      "maintenance": false,
107      "url": "https://3jmslogistics.com/"
108    },
109    {
110      "name": "3PE EXPRESS",
111      "country_code": "CN",
112      "carrier_code": "3PEE",
113      "active": true,
114      "maintenance": false,
115      "url": "http://www.3peex.com/"
116    },
117    {
118      "name": "4-72",
119      "country_code": "CO",
120      "carrier_code": "472P",
121      "active": true,
122      "maintenance": false,
123      "url": "https://www.4-72.com.co/"
124    },
125    {
126      "name": "4CUS",
127      "country_code": "US",
128      "carrier_code": "4CUS",
129      "active": true,
130      "maintenance": false,
131      "url": "https://www.4cus.com/"
132    },
133    {
134      "name": "4PLLAB",
135      "country_code": "CN",
136      "carrier_code": "4PLL",
137      "active": true,
138      "maintenance": false,
139      "url": "https://www.4pllab.cn/"
140    },
141    {
142      "name": "4PX",
143      "country_code": "CN",
144      "carrier_code": "4PXP",
145      "active": true,
146      "maintenance": false,
147      "url": "https://www.4px.com/"
148    },
149    {
150      "name": "4 SIDES",
151      "country_code": "RU",
152      "carrier_code": "4SDS",
153      "active": true,
154      "maintenance": false,
155      "url": "https://www.4sides.ru/"
156    },
157    {
158      "name": "5Post",
159      "country_code": "RU",
160      "carrier_code": "5PST",
161      "active": true,
162      "maintenance": false,
163      "url": "https://fivepost.ru/"
164    },
165    {
166      "name": "5UL",
167      "country_code": "CN",
168      "carrier_code": "5ULP",
169      "active": true,
170      "maintenance": false,
171      "url": "http://5ulogistics.com/"
172    },
173    {
174      "name": "6ZEX",
175      "country_code": "CN",
176      "carrier_code": "6ZEX",
177      "active": true,
178      "maintenance": false,
179      "url": "http://www.6zexpress.com/"
180    },
181    {
182      "name": "7Days SupplyChain",
183      "country_code": "CN",
184      "carrier_code": "7DAY",
185      "active": true,
186      "maintenance": false,
187      "url": "http://www.7days-express.com/"
188    },
189    {
190      "name": "7-ELEVEN",
191      "country_code": "TW",
192      "carrier_code": "711S",
193      "active": true,
194      "maintenance": false,
195      "url": "https://eservice.7-11.com.tw/"
196    },
197    {
198      "name": "7 Hours Express",
199      "country_code": "US",
200      "carrier_code": "7HRS",
201      "active": true,
202      "maintenance": false,
203      "url": "https://7hoursexpress.com/"
204    },
205    {
206      "name": "7TM",
207      "country_code": "CN",
208      "carrier_code": "7TMP",
209      "active": true,
210      "maintenance": false,
211      "url": "https://www.7-tm.com/"
212    },
213    {
214      "name": "99Minutos",
215      "country_code": "CL",
216      "carrier_code": "99MN",
217      "active": true,
218      "maintenance": false,
219      "url": "https://tracking.99minutos.com/"
220    },
221    {
222      "name": "A1 POST",
223      "country_code": "BG",
224      "carrier_code": "A1PT",
225      "active": true,
226      "maintenance": false,
227      "url": "https://a1post.bg/"
228    },
229    {
230      "name": "AAA Cooper Transportation",
231      "country_code": "US",
232      "carrier_code": "AAAC",
233      "active": true,
234      "maintenance": false,
235      "url": "http://www.aaacooper.com/"
236    },
237    {
238      "name": "ABF Freight",
239      "country_code": "US",
240      "carrier_code": "ABFF",
241      "active": true,
242      "maintenance": false,
243      "url": "https://www.abfs.com/"
244    },
245    {
246      "name": "ABT",
247      "country_code": "CN",
248      "carrier_code": "ABTP",
249      "active": true,
250      "maintenance": false,
251      "url": "http://www.arbat9.com/"
252    },
253    {
254      "name": "accufRATE",
255      "country_code": "US",
256      "carrier_code": "ACCU",
257      "active": true,
258      "maintenance": false,
259      "url": "http://www.accufrate.com/"
260    },
261    {
262      "name": "ACI Logistix",
263      "country_code": "US",
264      "carrier_code": "ACIL",
265      "active": true,
266      "maintenance": false,
267      "url": "https://acilogistix.com/"
268    },
269    {
270      "name": "ac logistics",
271      "country_code": "CN",
272      "carrier_code": "ACLS",
273      "active": true,
274      "maintenance": false,
275      "url": "http://www.sz-ac56.com/"
276    },
277    {
278      "name": "aCommerce",
279      "country_code": "TH",
280      "carrier_code": "ACMR",
281      "active": true,
282      "maintenance": false,
283      "url": "https://www.acommerce.asia/"
284    },
285    {
286      "name": "ACS",
287      "country_code": "GR",
288      "carrier_code": "ACSC",
289      "active": true,
290      "maintenance": false,
291      "url": "https://www.acscourier.net/"
292    },
293    {
294      "name": "ACS Logstic",
295      "country_code": "CN",
296      "carrier_code": "ACSL",
297      "active": true,
298      "maintenance": false,
299      "url": "http://www.acslogstic.com.cn/"
300    }
301  ]
302}