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>'
{
  "vessels": [
    {
      "mmsi": "268264001",
      "name": "TQ SAMSUN",
      "latitude": "44.988842",
      "longitude": "-8.8166847",
      "speed": "81",
      "course": "202",
      "heading": null,
      "typeSpecific": "Bulk Carrier"
    }
  ]
}
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 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[]