Live Tracking

Real-time vessel position (basic)

Changed on

Returns the latest AIS position and key attributes for a single vessel. Identify the vessel by one of: uuid, mmsi, or imo.

Credit cost: 1 per vessel found. Typical response time: ~5 ms.

get/api/v0/vessel

Request

Query parameters

uuidstring uuid
mmsistring
imostring

Response

Vessel found.

Example response

{
  "data": {
    "uuid": "b8625b67-7142-cfd1-7b85-595cebfe4191",
    "name": "MAERSK CHENNAI",
    "mmsi": "566093000",
    "imo": "9525338",
    "country_iso": "SG",
    "country_name": "Singapore",
    "type": "Cargo - Hazard A (Major)",
    "type_specific": "Container Ship",
    "lat": 6.303473,
    "lon": 3.201678,
    "speed": 14.2,
    "course": 326,
    "heading": 226,
    "navigational_status": "Under way using engine",
    "destination": "ROTTERDAM",
    "last_position_epoch": 1624127400,
    "last_position_UTC": "2021-06-20T08:30:00Z",
    "area": "North Sea"
  },
  "meta": {
    "duration": 0.012,
    "endpoint": "/api/v0/vessel",
    "success": true,
    "next": "00e32b7a-4067-d6b2-8d73-2bdda4fe72bb"
  }
}

Changes

    • warning

      deleted the query request parameter api-key

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status