PRproject44
Rail: Tracking

Initialize a shipment for tracking.

If the shipment is initialized by using geoCoordinates instead of an address, it may be possible that a street address will not be returned in the response.

<br/><h4><b>Required Fields</h4></b>

<ul><li><b> shipmentIdentifiers: </b> (if no trackingStartDateTime provided) </li><ul><li> type </li><li> value </li></ul><li><b> equipmentIdentifiers: </b></li><ul><li> type </li><li> value </li></ul><li> trackingStartDateTime (if no shipmentIdentifiers provided) </li></ul>
post/api/v4/rail/shipments

Request

Request body

idinteger

DEPRECATED: The project44-generated id for the rail shipment. This may not be provided when creating a shipment, but will always be returned in the shipment confirmation. This id may be used in subsequent API calls to reference a shipment. This field is deprecated, use railLegId instead.

masterShipmentIdstring uuid

This id links 1 or more legs as part of the same overall shipment. For intermodal shipments, pass an existing masterShipmentId to link this rail leg to the overall master shipment. Otherwise pass any valid new UUID to create a new shipment. If no masterShipmentId is passed on POST request a new UUID will be generated. This value will always be returned on all responses.

railLegIdstring uuid

Identifies the leg of the journey. Each piece of equipment has a unique id for each mode that it travels on.This id may be used in subsequent API calls to reference this shipment leg.

trackingStartDateTimestring

Tracking for this shipment will begin at this time. This should be set to the time when your shipment has been loaded into the container or rail car. Cannot be more than 90 days in the past or 90 days in the future. You must pass in either a shipment identifier or a tracking start date time.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.