The Freight bookings API provides 24/7 connection between our customers system and KiwiRail's system allowing customers to send automatic electronic messages to create, update and cancel bookings with KiwiRail. This provides an opportunity for B2B integration without the need for any manual processes delivering; improved processing time, reduction in errors, integration of business data, and process optimisation.
Provided below is a swagger file for our customers to use to be able to create bookings through our Freight Bookings API. The swagger file is provided in a JSON format. If you would like to know what each parameter refers to, you can simply download the Swagger Definition document or download the swagger file and use an online tool such as (Swagger Editor) to view these details.
Freight Booking Swagger File: Swagger File V1.0.12 (you can save this as a .json file)
Swagger Definition Document: Booking Swagger Definition Document | Bookings Specifications
Samples: Sample Request | Sample Response
Reference Data: EquipmentGroup | EquipmentClass
Customers can validate successful booking requests with the sample files provided against the test end points before making live booking requests into production. This will provide assurance that a return booking confirmation has been successfully received from KiwiRail.
To start your digital journey with KiwiRail, reach out to our Customer Delivery Team.
TEST Request
Description: Create booking
URL: https://api-uat.kiwirail.co.nz/V1/bookings
Method: POST
Description: Update booking
URL: https://api-uat.kiwirail.co.nz/V1/bookings/<bookingid>
Method: PUT
Description: Cancel booking
URL: https://api-uat.kiwirail.co.nz/V1/bookings/<bookingid>
Method: DELETE
PROD Request
Description: Create booking
URL: https://api.kiwirail.co.nz/V1/bookings
Method: POST
Description: Update booking
URL: https://api.kiwirail.co.nz/V1/bookings/<bookingid>
Method: PUT
Description: Cancel booking
URL: https://api.kiwirail.co.nz/V1/bookings/<bookingid>
Method: DELETE