Getting Started
In Depth Guides
Useful Info
Shipments
Tracking Requests
Webhooks
Webhook Notifications
Containers
Shipping Lines
Terminals
Get a vessel using the id
Returns a vessel by it’s given identifier
curl --request GET \
--url https://api.terminal49.com/v2/vessels/{id} \
--header 'Authorization: <api-key>'
{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "vessel",
"attributes": {
"name": "Ever Given",
"imo": "9811000",
"mmsi": "353136000",
"latitude": 25.29845,
"longitude": 121.217,
"nautical_speed_knots": 90,
"navigational_heading_degrees": 194,
"position_timestamp": "2023-07-28T14:01:37Z"
}
}
}
Authorizations
Token YOUR_API_TOKEN
The APIs require authentication to be done using header-based API Key and Secret Authentication.
API key and secret are sent va the Authorization
request header.
You send your API key and secret in the following way:
Authorization: Token YOUR_API_KEY
Path Parameters
Response
vessel
The name of the ship or vessel
"Ever Given"
International Maritime Organization (IMO) number
"9811000"
Maritime Mobile Service Identity (MMSI)
"353136000"
The current latitude position of the vessel
25.29845
The current longitude position of the vessel
121.217
The current speed of the ship in knots (nautical miles per hour)
90
The current heading of the ship in degrees, where 0 is North, 90 is East, 180 is South, and 270 is West
194
The timestamp of when the ship's position was last recorded, in ISO 8601 date and time format
"2023-07-28T14:01:37Z"
Was this page helpful?
curl --request GET \
--url https://api.terminal49.com/v2/vessels/{id} \
--header 'Authorization: <api-key>'
{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "vessel",
"attributes": {
"name": "Ever Given",
"imo": "9811000",
"mmsi": "353136000",
"latitude": 25.29845,
"longitude": 121.217,
"nautical_speed_knots": 90,
"navigational_heading_degrees": 194,
"position_timestamp": "2023-07-28T14:01:37Z"
}
}
}