General considerations
Last updated
Last updated
Before using our REST API services, you must obtain:
An API key from your SHIPTIFY sales representative.
Galaxy Manager access for the user associated with the API.
The API key is tied to a specific user. Therefore, when you generate a shipment via the API, it will be attributed to that user within the platform. This applies to all operations performed through the API.
The API key is persistent and does not expire. You can test your API key using the “Hello” endpoint in the Postman collection.
Shiptify provides two separate environments for setup:
Test Environment [BLU]: https://api.blu.shiptify.com
Production Environment: https://api.shiptify.com
This documentation includes a Postman file with all the endpoints and information outlined here, which can be imported directly into your Postman project.
A shipper creates 1 Shipment Request, also known as booking, which is identified by an #SR ID.
When 1 Shipment Request (#SR ID) is confirmed by a carrier, it generates at least 1 shipment, identified by its #SH ID.
However, if the Shipment Request (#SR ID) is not confirmed, no shipment (#SH ID) is created.
For multi-container or multi-shipment requests, a single Shipment Request (#SR ID) can generate more than one shipment, resulting in multiple _#SH ID_s.
A shipment (#SH ID) generates at least two Tracking Points (#TP ID): 1 for pickup and 1 for delivery. There can also be additional tracking points depending on the process.
A Shipment Request and/or a Shipment can have zero or multiple documents attached to it. Each document is identified with its Attachment ID.