In order to retrieve containers associated with a specific Bill of Lading, a GET
request must be submitted to
https://oceantrack.gatehouse.com/api/container_info/get_bol/bol
where bol
is replaced by the BoL of interest.
We only accept GET
requests on Bill of Ladings already submitted to our system which are associated with your account. For a newly tracked Bill of Lading the output may return empty, after some time containers will be added to the Bill of Lading as we gather for information about the specific Bill of Lading. This process generally takes about five minutes, after which events for any specific container may begin to be retrieved on demand.
Additionally, including Content-Type: application/json
in the headers is necessary.
Note that Basic Authentication in the form of a username and password is necessary to submit a successful request. If you do not have any authentication details, please contact us.
Response
Requesting a Bill of Lading returns the list of associated containers and their current tracking status. If containers are still being processed, they will be marked as Untracked
whereas containers with matched and validated data are marked as Tracked
. All container related data is located in the container property.
{ "result": { "AAAA7618468": { "container_status": "Tracked", "container: { "shipment": { "equipment": { ... }, "container_events": [ ... ], "voyage_events": [ ... ], "generated_at: 1234567890 } } }, "BBBB5649690": "Tracked": { "container_status": "Tracked", "container: { "shipment": { "equipment": { ... }, "container_events": [ ... ], "voyage_events": [ ... ], "generated_at: 1234567890 } } } } }
Errors
If you attempt to check a Bill of Lading which has not been submitted, or submit an incorrectly formatted Bill of Lading, the following error is returned:
{
"error": "ABCD123456789 is not actively being tracked"
}
Python Example
The following code snippet returns containers for Bill of Lading ABCD123456789
.
import json
import requests
from requests.auth import HTTPBasicAuth
response = requests.get(
"https://oceantrack.gatehouse.com/api/container_info/get_bol/ABCD123456789",
headers={"Content-Type": "application/json"},
auth=HTTPBasicAuth("user", "pass"))
print(json.loads(response.content))