Skip to main content
GET
/
vessels
/
{imo}
Get a vessel using the imo
curl --request GET \
  --url https://api.terminal49.com/v2/vessels/{imo} \
  --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",
      "positions": [
        {
          "latitude": 1.477285,
          "longitude": 104.535533333,
          "heading": 51,
          "timestamp": "2025-05-23T19:14:22Z",
          "estimated": false
        }
      ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://terminal49.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

​
imo
string
required

Query Parameters

​
show_positions[from_timestamp]
string<date-time>

ISO 8601 timestamp to filter positions from. 7 days by default.

Example:

"2025-05-20T00:00:00Z"

​
show_positions[to_timestamp]
string<date-time>

ISO 8601 timestamp to filter positions up to. Current time by default.

Example:

"2025-05-24T00:00:00Z"

Response

OK

​
data
vessel · object