Skip to main content
GET
Vessel Location Bulk Search
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.

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