Skip to main content
POST
/
get-vessels-by-navigational-status
curl --request POST \
  --url https://datadocked.com/api/vessels_operations/get-vessels-by-navigational-status \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "navigational_status": "at-anchor",
  "world_zone": "baltic-sea",
  "vessel_type": "bulk-carrier"
}
'
{
  "vessels": [
    {
      "imo": "9876543",
      "mmsi": "123456789",
      "name": "VESSEL NAME",
      "country": "Panama",
      "shipType": "Bulk Carrier"
    }
  ]
}
Returns a list of vessels currently matching a specified AIS navigational status, with optional filters for world zone, vessel type, laden condition, and for-order availability.
Credits: 10 credits per request

​
Request Parameters

FieldTypeRequiredDescription
navigational_statusstringYesAIS navigational status
world_zonestringConditionalRequired unless status is drifting, constrained, or aground
vessel_typestringNoFilter by vessel type
ladenstringNoLaden/ballast condition
for_orderstringNoWhether vessel is sailing for orders
ValueDescription
under-wayVessel is underway using engine
at-anchorVessel is at anchor
driftingVessel is drifting (world_zone not required)
restrictedVessel has restricted manoeuvrability
constrainedVessel is constrained by her draught (world_zone not required)
mooredVessel is moored
agroundVessel is aground (world_zone not required)
fishingVessel is engaged in fishing
sailingVessel is underway sailing

​
World Zones

ValueRegion
north-canadaNorth Canada
great-lakesGreat Lakes
north-west-atlantic-oceanNW Atlantic Ocean
us-east-coastUS East Coast
us-inlandUS Inland
gulf-of-mexicoGulf of Mexico
caribbean-seaCaribbean Sea
north-america-west-coastNorth America West Coast
south-america-east-coastSouth America East Coast
south-america-west-coastSouth America West Coast
south-america-inlandSouth America Inland
north-east-atlantic-oceanNE Atlantic Ocean
north-seaNorth Sea
baltic-seaBaltic Sea
west-mediterraneanWest Mediterranean
east-mediterraneanEast Mediterranean
adriatic-seaAdriatic Sea
aegean-seaAegean Sea
marmara-seaMarmara Sea
black-seaBlack Sea
azov-seaAzov Sea
caspian-seaCaspian Sea
europe-inlandEurope Inland
north-russiaNorth Russia
russia-inlandRussia Inland
west-africaWest Africa
south-africaSouth Africa
east-africaEast Africa
red-seaRed Sea
persian-gulfPersian Gulf
arabian-seaArabian Sea
indian-coastIndian Coast
indian-oceanIndian Ocean
south-east-asiaSouth-East Asia
indonesiaIndonesia
china-coastChina Coast
east-asiaEast Asia
west-australiaWest Australia
east-australiaEast Australia
north-pacific-oceanNorth Pacific Ocean
south-pacific-oceanSouth Pacific Ocean

​
Vessel Types

cargo-vessels, bulk-carrier, general-cargo, container-ship, reefer, ro-ro, vehicles-carrier, cement-carrier, wood-chips carrier, urea-carrier, aggregates-carrier, limestone-carrier, landing-craft, livestock-carrier, heavy-load-carrier
tankers, crude-oil-tanker, oil-products-tanker, chemical-oil tanker, lng-tanker, lpg-tanker, asphalt-bitumen, bunkering-tanker, fso-fpso, other-tankers
passenger-and-cruise-ships, cruise-ships, passenger-cargo-ships, passenger-roro-ships, passenger-ships
fishing-ships, yachts-or-sailing-vessels, military, tugs, other-type-or-auxiliary, unknown

​
Laden Condition

ValueDescription
ballastLoad factor 0–49%
partialLoad factor 50–75%
ladenLoad factor 76–100%

​
For Order

ValueDescription
trueVessel is sailing for orders
falseVessel is not sailing for orders

​
Response Fields

FieldTypeDescription
vesselsarrayList of matched vessels (empty array if none found)
vessels[].imostringIMO number
vessels[].mmsistringMMSI number
vessels[].namestringVessel name
vessels[].countrystringCountry of registration
vessels[].shipTypestringVessel type label

​
Examples

​
Bulk carriers at anchor in the Baltic Sea

{
  "navigational_status": "at-anchor",
  "world_zone": "baltic-sea",
  "vessel_type": "bulk-carrier"
}

​
All drifting vessels (no zone required)

{
  "navigational_status": "drifting"
}

​
Laden crude oil tankers moored in the Persian Gulf, for orders

{
  "navigational_status": "moored",
  "world_zone": "persian-gulf",
  "vessel_type": "crude-oil-tanker",
  "laden": "laden",
  "for_order": "true"
}

Authorizations

​
x-api-key
string
header
required

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

Body

application/json
​
navigational_status
enum<string>
required

AIS navigational status. For drifting, constrained, and aground statuses, world_zone is not required.

Available options:
under-way,
at-anchor,
drifting,
restricted,
constrained,
moored,
aground,
fishing,
sailing
​
world_zone
enum<string>

Ocean/sea zone. Required unless navigational_status is drifting, constrained, or aground.

Available options:
north-canada,
great-lakes,
north-west-atlantic-ocean,
us-east-coast,
us-inland,
gulf-of-mexico,
caribbean-sea,
north-america-west-coast,
south-america-east-coast,
south-america-west-coast,
south-america-inland,
north-east-atlantic-ocean,
north-sea,
baltic-sea,
west-mediterranean,
east-mediterranean,
adriatic-sea,
aegean-sea,
marmara-sea,
black-sea,
azov-sea,
caspian-sea,
europe-inland,
north-russia,
russia-inland,
west-africa,
south-africa,
east-africa,
red-sea,
persian-gulf,
arabian-sea,
indian-coast,
indian-ocean,
south-east-asia,
indonesia,
china-coast,
east-asia,
west-australia,
east-australia,
north-pacific-ocean,
south-pacific-ocean
​
vessel_type
enum<string>

Filter by vessel type

Available options:
cargo-vessels,
bulk-carrier,
general-cargo,
container-ship,
reefer,
ro-ro,
vehicles-carrier,
cement-carrier,
wood-chips carrier,
urea-carrier,
aggregates-carrier,
limestone-carrier,
landing-craft,
livestock-carrier,
heavy-load-carrier,
tankers,
crude-oil-tanker,
oil-products-tanker,
chemical-oil tanker,
lng-tanker,
lpg-tanker,
asphalt-bitumen,
bunkering-tanker,
fso-fpso,
other-tankers,
passenger-and-cruise-ships,
cruise-ships,
passenger-cargo-ships,
passenger-roro-ships,
passenger-ships,
fishing-ships,
yachts-or-sailing-vessels,
military,
tugs,
other-type-or-auxiliary,
unknown
​
laden
enum<string>

Laden/ballast condition. ballast=0-49%, partial=50-75%, laden=76-100%

Available options:
ballast,
partial,
laden
​
for_order
enum<string>

Whether vessel is sailing for orders

Available options:
true,
false

Response

Successful response with matching vessels

​
vessels
object[]