Skip to main content
GET
Get Vessels by Area
Find all vessels within a specified circular geographic area.
Credits: 10 credits per request

Parameters

Define a circular search area using:
  • latitude: Center point latitude (up to 1 decimal place)
  • longitude: Center point longitude (up to 1 decimal place)
  • circle_radius: Search radius in kilometers (maximum 50km)

Example

Search for vessels within 50km of coordinates 45.0, -9.0:
This endpoint currently uses terrestrial AIS data only. Satellite AIS coverage will be added in a future update.

Response

Returns a vessels array. Each entry contains:
  • mmsi — Maritime Mobile Service Identity
  • name — Vessel name
  • latitude, longitude — Current position
  • speed — Speed over ground
  • course — Course over ground (nullable)
  • heading — Heading (nullable)
  • typeSpecific — Specific vessel type (e.g. Bulk Carrier, Container Ship)

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

latitude
number<float>
required

The center latitude coordinate for the search area (up to 1 decimal place).

longitude
number<float>
required

The center longitude coordinate for the search area (up to 1 decimal place).

circle_radius
integer
required

The search radius in kilometers (maximum 50km).

Required range: x <= 50

Response

Successful response with vessels in area

vessels
object[]