Real-time positions for up to 100 vessels

Changed on Sep 8, 2026

Retrieve tracking data for up to 100 vessels in one call by repeating the mmsi, imo, or uuid parameter. Returns the same fields as /vessel. Credits are only deducted for vessels successfully retrieved.

In rare cases a single identifier matches more than one vessel, for example a placeholder MMSI shared by several ships. This endpoint returns every match and charges per vessel returned. Use /vessel when you need exactly one vessel per identifier.

Credit cost: 1 per vessel returned, capped at 100 credits per request.

get/api/v0/vessel_bulk

Request

Base URL
https://api.datalastic.com
Auth
- API key in header x-api-key
- or API key in query parameter api-key
TypeScript
https://skmtc.dev/datalastic/apis/datalastic-maritime-api/docs/api/v0/vessel_bulk/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

mmsistring[]

MMSI number. Repeat the parameter for multiple vessels (max 100 identifiers per request).

imostring[]

IMO number. Repeat the parameter for multiple vessels (max 100 identifiers per request).

uuidstring[]

Datalastic vessel UUID. Repeat the parameter for multiple vessels (max 100 identifiers per request).

Response

Results for all queried vessels.

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

Sep 8, 2026a29cf323d1c3 Revision changes
- warning
  deleted the query request parameter api-key
- info
  added the new optional query request parameter uuid
- info
  for the query request parameter imo, the type was generalized from string to array
- info
  for the query request parameter mmsi, the type was generalized from string to array
- 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 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

Operation history