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

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