Home

Introduction

Rail Tracking API

version 1

Rail Tracking allows determining the current position of rail cargo on the World Map. To track your cargo by land, just specify the equipment ID provided by the rail carriers.

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

Rail 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/rail

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:F2316929

  • carrier_codeOptionalstring

    Carrier code - see Available carriers

    Examples:KIWI

  • 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": "F2316929",
7      "carrier_code": null
8    },
9    "updated_at": "2024-11-05 12:58:56",
10    "railway_company": {
11      "name": "KiwiRail",
12      "url": "https://www.kiwirail.co.nz/",
13      "carrier_code": "KIWI"
14    }
15  },
16  "data": {
17    "equipments": [
18      {
19        "status": "DELIVERED",
20        "number": "YJ339",
21        "wagon_number": null,
22        "train_number": "248",
23        "from": {
24          "name": "PALMERSTON NORTH",
25          "state": null,
26          "country": "New Zealand",
27          "country_code": "NZ",
28          "locode": null,
29          "station_code": null,
30          "railway_zone": null,
31          "division": null,
32          "lat": -40.344364473809,
33          "lng": 175.59442515931
34        },
35        "to": {
36          "name": "HAMILTON",
37          "state": null,
38          "country": "New Zealand",
39          "country_code": "NZ",
40          "locode": null,
41          "station_code": null,
42          "railway_zone": null,
43          "division": null,
44          "lat": -37.791007251802,
45          "lng": 175.26531039564
46        },
47        "departure_datetime": {
48          "estimated": null,
49          "actual": "2015-08-01 22:58:00"
50        },
51        "arrival_datetime": {
52          "estimated": null,
53          "actual": "2015-08-02 07:24:00"
54        },
55        "routes": [
56          {
57            "order_id": 1,
58            "from": {
59              "name": "PALMERSTON NORTH",
60              "state": null,
61              "country": "New Zealand",
62              "country_code": "NZ",
63              "locode": null,
64              "station_code": null,
65              "railway_zone": null,
66              "division": null,
67              "lat": -40.344364473809,
68              "lng": 175.59442515931
69            },
70            "to": {
71              "name": "HAMILTON",
72              "state": null,
73              "country": "New Zealand",
74              "country_code": "NZ",
75              "locode": null,
76              "station_code": null,
77              "railway_zone": null,
78              "division": null,
79              "lat": -37.791007251802,
80              "lng": 175.26531039564
81            },
82            "transport_mode": "RAIL",
83            "departure_datetime": {
84              "estimated": null,
85              "actual": "2015-08-01 22:58:00"
86            },
87            "arrival_datetime": {
88              "estimated": null,
89              "actual": "2015-08-02 07:24:00"
90            },
91            "path": []
92          }
93        ],
94        "events": [
95          {
96            "order_id": 1,
97            "event_code": "PUL",
98            "description": "Pulled",
99            "datetime": {
100              "estimated": null,
101              "actual": "2015-08-01 22:57:00"
102            },
103            "location": {
104              "name": "PALMERSTON NORTH",
105              "state": null,
106              "country": "New Zealand",
107              "country_code": "NZ",
108              "locode": null,
109              "station_code": null,
110              "railway_zone": null,
111              "division": null,
112              "lat": -40.344364473809,
113              "lng": 175.59442515931
114            },
115            "transport_mode": "RAIL"
116          },
117          {
118            "order_id": 2,
119            "event_code": "DEP",
120            "description": "Departed, train: 248",
121            "datetime": {
122              "estimated": null,
123              "actual": "2015-08-01 22:58:00"
124            },
125            "location": {
126              "name": "PALMERSTON NORTH",
127              "state": null,
128              "country": "New Zealand",
129              "country_code": "NZ",
130              "locode": null,
131              "station_code": null,
132              "railway_zone": null,
133              "division": null,
134              "lat": -40.344364473809,
135              "lng": 175.59442515931
136            },
137            "transport_mode": "RAIL"
138          },
139          {
140            "order_id": 3,
141            "event_code": "ARR",
142            "description": "Arrived, train: 248",
143            "datetime": {
144              "estimated": null,
145              "actual": "2015-08-02 07:24:00"
146            },
147            "location": {
148              "name": "HAMILTON",
149              "state": null,
150              "country": "New Zealand",
151              "country_code": "NZ",
152              "locode": null,
153              "station_code": null,
154              "railway_zone": null,
155              "division": null,
156              "lat": -37.791007251802,
157              "lng": 175.26531039564
158            },
159            "transport_mode": "RAIL"
160          }
161        ]
162      },
163      {
164        "status": "DELIVERED",
165        "number": "YJ190",
166        "wagon_number": null,
167        "train_number": "248",
168        "from": {
169          "name": "PALMERSTON NORTH",
170          "state": null,
171          "country": "New Zealand",
172          "country_code": "NZ",
173          "locode": null,
174          "station_code": null,
175          "railway_zone": null,
176          "division": null,
177          "lat": -40.344364473809,
178          "lng": 175.59442515931
179        },
180        "to": {
181          "name": "HAMILTON",
182          "state": null,
183          "country": "New Zealand",
184          "country_code": "NZ",
185          "locode": null,
186          "station_code": null,
187          "railway_zone": null,
188          "division": null,
189          "lat": -37.791007251802,
190          "lng": 175.26531039564
191        },
192        "departure_datetime": {
193          "estimated": null,
194          "actual": "2015-08-01 22:58:00"
195        },
196        "arrival_datetime": {
197          "estimated": null,
198          "actual": "2015-08-02 07:24:00"
199        },
200        "routes": [
201          {
202            "order_id": 1,
203            "from": {
204              "name": "PALMERSTON NORTH",
205              "state": null,
206              "country": "New Zealand",
207              "country_code": "NZ",
208              "locode": null,
209              "station_code": null,
210              "railway_zone": null,
211              "division": null,
212              "lat": -40.344364473809,
213              "lng": 175.59442515931
214            },
215            "to": {
216              "name": "HAMILTON",
217              "state": null,
218              "country": "New Zealand",
219              "country_code": "NZ",
220              "locode": null,
221              "station_code": null,
222              "railway_zone": null,
223              "division": null,
224              "lat": -37.791007251802,
225              "lng": 175.26531039564
226            },
227            "transport_mode": "RAIL",
228            "departure_datetime": {
229              "estimated": null,
230              "actual": "2015-08-01 22:58:00"
231            },
232            "arrival_datetime": {
233              "estimated": null,
234              "actual": "2015-08-02 07:24:00"
235            },
236            "path": []
237          }
238        ],
239        "events": [
240          {
241            "order_id": 1,
242            "event_code": "PUL",
243            "description": "Pulled",
244            "datetime": {
245              "estimated": null,
246              "actual": "2015-08-01 22:57:00"
247            },
248            "location": {
249              "name": "PALMERSTON NORTH",
250              "state": null,
251              "country": "New Zealand",
252              "country_code": "NZ",
253              "locode": null,
254              "station_code": null,
255              "railway_zone": null,
256              "division": null,
257              "lat": -40.344364473809,
258              "lng": 175.59442515931
259            },
260            "transport_mode": "RAIL"
261          },
262          {
263            "order_id": 2,
264            "event_code": "DEP",
265            "description": "Departed, train: 248",
266            "datetime": {
267              "estimated": null,
268              "actual": "2015-08-01 22:58:00"
269            },
270            "location": {
271              "name": "PALMERSTON NORTH",
272              "state": null,
273              "country": "New Zealand",
274              "country_code": "NZ",
275              "locode": null,
276              "station_code": null,
277              "railway_zone": null,
278              "division": null,
279              "lat": -40.344364473809,
280              "lng": 175.59442515931
281            },
282            "transport_mode": "RAIL"
283          },
284          {
285            "order_id": 3,
286            "event_code": "ARR",
287            "description": "Arrived, train: 248",
288            "datetime": {
289              "estimated": null,
290              "actual": "2015-08-02 07:24:00"
291            },
292            "location": {
293              "name": "HAMILTON",
294              "state": null,
295              "country": "New Zealand",
296              "country_code": "NZ",
297              "locode": null,
298              "station_code": null,
299              "railway_zone": null,
300              "division": null,
301              "lat": -37.791007251802,
302              "lng": 175.26531039564
303            },
304            "transport_mode": "RAIL"
305          }
306        ]
307      }
308    ]
309  }
310}

Available carriers

get/info/railway_companies

Information about the carriers we support

Headers

Content-Typeapplication/json

Response example
1{
2  "status": "success",
3  "message": "OK",
4  "data": [
5    {
6      "name": "Canadian National Railway Company",
7      "carrier_code": "CNRC",
8      "active": true,
9      "maintenance": false,
10      "url": "https://www.cn.ca/en/"
11    },
12    {
13      "name": "Indian Railways",
14      "carrier_code": "INDR",
15      "active": true,
16      "maintenance": false,
17      "url": "https://www.indianrail.gov.in/"
18    },
19    {
20      "name": "KiwiRail",
21      "carrier_code": "KIWI",
22      "active": true,
23      "maintenance": false,
24      "url": "https://www.kiwirail.co.nz/"
25    },
26    {
27      "name": "Tiedada Group",
28      "carrier_code": "TDDG",
29      "active": true,
30      "maintenance": false,
31      "url": "https://www.tiedada.com/"
32    }
33  ]
34}