Skip to main content
GET
/
get-vessels-by-area
Get Vessels by Area
curl --request GET \
  --url https://datadocked.com/api/vessels_operations/get-vessels-by-area \
  --header 'x-api-key: <api-key>'
[
  {
    "mmsi": "<string>",
    "name": "<string>",
    "latitude": "<string>",
    "longitude": "<string>",
    "speed": "<string>",
    "course": "<string>",
    "heading": "<string>"
  }
]
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: 
?latitude=45.0&longitude=-9.0&circle_radius=50
This endpoint currently uses terrestrial AIS data only. Satellite AIS coverage will be added in a future update.

​
Response

Returns an array of vessels in the area with:
  • MMSI and name
  • Current position (latitude, longitude)
  • Speed, course, and heading

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

​
mmsi
string
​
name
string
​
latitude
string
​
longitude
string
​
speed
string
​
course
string
​
heading
string | null