Skip to main content
GET
/
get-vessels-location-bulk-search
Vessel Location Bulk Search
curl --request GET \
  --url https://datadocked.com/api/vessels_operations/get-vessels-location-bulk-search \
  --header 'x-api-key: <api-key>'
{
  "total_requested": 123,
  "successful": 123,
  "failed": 123,
  "results": [
    {
      "name": "<string>",
      "imo": "<string>",
      "mmsi": "<string>",
      "latitude": "<string>",
      "longitude": "<string>",
      "etaUtc": "<string>",
      "atdUtc": "<string>",
      "course": "<string>",
      "heading": "<string>",
      "speed": "<string>",
      "draught": "<string>",
      "navigationalStatus": "<string>",
      "destination": "<string>",
      "lastPort": "<string>",
      "callsign": "<string>",
      "positionReceived": "<string>",
      "updateTime": "<string>",
      "unlocodeDestination": "<string>",
      "unlocodeLastport": "<string>",
      "typeSpecific": "<string>",
      "dataSource": "<string>"
    }
  ],
  "userRequest": "<string>"
}
Query multiple vessel locations in a single request using comma-separated IMO or MMSI numbers.
Credits: 1 credit per vessel queried (variable total)

​
Usage

Pass a comma-separated list of IMO or MMSI numbers (no spaces) in the imo_or_mmsi parameter. 
?imo_or_mmsi=9465411,215767000,9247431

​
Limits

  • Maximum 50 vessels per request
  • Credits charged per vessel found
This endpoint currently uses terrestrial AIS data only. Satellite AIS coverage will be added in a future update.

​
Response

The response includes:
  • total_requested: Number of vessels in your query
  • successful: Number of vessels found
  • failed: Number of vessels not found
  • results: Array of vessel location data

Authorizations

​
x-api-key
string
header
required

Your personal API key found in your profile dashboard at https://datadocked.com/dashboard/my_keys

Query Parameters

​
imo_or_mmsi
string
required

Comma-separated list of IMO or MMSI numbers (no spaces). Maximum 50 per request.

Response

Successful response with multiple vessel locations

​
total_requested
integer

Number of vessels requested

​
successful
integer

Number of vessels found

​
failed
integer

Number of vessels not found

​
results
object[]
​
userRequest
string

Original query string