> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datadocked.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Vessels by Navigational Status
> Returns vessels matching a specified AIS navigational status, with optional filters for world zone, vessel type, laden condition, and for-order availability. Costs 10 credits per request. Rate limit: 15 requests/min.
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
| Field | Type | Required | Description |
| --------------------- | ------ | ----------- | ----------------------------------------------------------------- |
| `navigational_status` | string | Yes | AIS navigational status |
| `world_zone` | string | Conditional | Required unless status is `drifting`, `constrained`, or `aground` |
| `vessel_type` | string | No | Filter by vessel type |
| `laden` | string | No | Laden/ballast condition |
| `for_order` | string | No | Whether vessel is sailing for orders |
## Navigational Status Values
| Value | Description |
| ------------- | --------------------------------------------------------------- |
| `under-way` | Vessel is underway using engine |
| `at-anchor` | Vessel is at anchor |
| `drifting` | Vessel is drifting (world\_zone not required) |
| `restricted` | Vessel has restricted manoeuvrability |
| `constrained` | Vessel is constrained by her draught (world\_zone not required) |
| `moored` | Vessel is moored |
| `aground` | Vessel is aground (world\_zone not required) |
| `fishing` | Vessel is engaged in fishing |
| `sailing` | Vessel is underway sailing |
## World Zones
| Value | Region |
| --------------------------- | ------------------------ |
| `north-canada` | North Canada |
| `great-lakes` | Great Lakes |
| `north-west-atlantic-ocean` | NW Atlantic Ocean |
| `us-east-coast` | US East Coast |
| `us-inland` | US Inland |
| `gulf-of-mexico` | Gulf of Mexico |
| `caribbean-sea` | Caribbean Sea |
| `north-america-west-coast` | North America West Coast |
| `south-america-east-coast` | South America East Coast |
| `south-america-west-coast` | South America West Coast |
| `south-america-inland` | South America Inland |
| `north-east-atlantic-ocean` | NE Atlantic Ocean |
| `north-sea` | North Sea |
| `baltic-sea` | Baltic Sea |
| `west-mediterranean` | West Mediterranean |
| `east-mediterranean` | East Mediterranean |
| `adriatic-sea` | Adriatic Sea |
| `aegean-sea` | Aegean Sea |
| `marmara-sea` | Marmara Sea |
| `black-sea` | Black Sea |
| `azov-sea` | Azov Sea |
| `caspian-sea` | Caspian Sea |
| `europe-inland` | Europe Inland |
| `north-russia` | North Russia |
| `russia-inland` | Russia Inland |
| `west-africa` | West Africa |
| `south-africa` | South Africa |
| `east-africa` | East Africa |
| `red-sea` | Red Sea |
| `persian-gulf` | Persian Gulf |
| `arabian-sea` | Arabian Sea |
| `indian-coast` | Indian Coast |
| `indian-ocean` | Indian Ocean |
| `south-east-asia` | South-East Asia |
| `indonesia` | Indonesia |
| `china-coast` | China Coast |
| `east-asia` | East Asia |
| `west-australia` | West Australia |
| `east-australia` | East Australia |
| `north-pacific-ocean` | North Pacific Ocean |
| `south-pacific-ocean` | South 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
| Value | Description |
| --------- | ------------------- |
| `ballast` | Load factor 0–49% |
| `partial` | Load factor 50–75% |
| `laden` | Load factor 76–100% |
## For Order
| Value | Description |
| ------- | -------------------------------- |
| `true` | Vessel is sailing for orders |
| `false` | Vessel is not sailing for orders |
## Response Fields
| Field | Type | Description |
| -------------------- | ------ | --------------------------------------------------- |
| `vessels` | array | List of matched vessels (empty array if none found) |
| `vessels[].imo` | string | IMO number |
| `vessels[].mmsi` | string | MMSI number |
| `vessels[].name` | string | Vessel name |
| `vessels[].country` | string | Country of registration |
| `vessels[].shipType` | string | Vessel type label |
## Examples
### Bulk carriers at anchor in the Baltic Sea
```json theme={null}
{
"navigational_status": "at-anchor",
"world_zone": "baltic-sea",
"vessel_type": "bulk-carrier"
}
```
### All drifting vessels (no zone required)
```json theme={null}
{
"navigational_status": "drifting"
}
```
### Laden crude oil tankers moored in the Persian Gulf, for orders
```json theme={null}
{
"navigational_status": "moored",
"world_zone": "persian-gulf",
"vessel_type": "crude-oil-tanker",
"laden": "laden",
"for_order": "true"
}
```
## OpenAPI
````yaml POST /get-vessels-by-navigational-status
openapi: 3.1.0
info:
title: Data Docked Maritime API
description: >-
A comprehensive maritime data API providing real-time vessel tracking, port
operations, inspection data, and more. Access AIS data, vessel particulars,
management information, and historical tracking data.
version: 1.0.0
contact:
name: Data Docked Support
url: https://datadocked.com/contact
servers:
- url: https://datadocked.com/api/vessels_operations
description: Production server
security:
- apiKey: []
tags:
- name: Account
description: Account management endpoints
- name: Vessel Operations
description: Vessel data, location, and tracking endpoints
- name: Port Operations
description: Port calls and port data endpoints
paths:
/get-vessels-by-navigational-status:
post:
tags:
- Vessel Operations
summary: Vessels by Navigational Status
description: >-
Returns vessels matching a specified AIS navigational status, with
optional filters for world zone, vessel type, laden condition, and
for-order availability. Costs 10 credits per request. Rate limit: 15
requests/min.
operationId: getVesselsByNavigationalStatus
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/NavigationalStatusRequest'
examples:
bulkCarriersAtAnchor:
summary: Bulk carriers at anchor in Baltic Sea
value:
navigational_status: at-anchor
world_zone: baltic-sea
vessel_type: bulk-carrier
driftingVessels:
summary: All drifting vessels (no zone required)
value:
navigational_status: drifting
ladenTankersForOrders:
summary: Laden crude tankers moored in Persian Gulf, for orders
value:
navigational_status: moored
world_zone: persian-gulf
vessel_type: crude-oil-tanker
laden: laden
for_order: 'true'
responses:
'200':
description: Successful response with matching vessels
content:
application/json:
schema:
$ref: '#/components/schemas/NavigationalStatusResponse'
example:
vessels:
- imo: '9876543'
mmsi: '123456789'
name: VESSEL NAME
country: Panama
shipType: Bulk Carrier
'400':
description: >-
Bad request - Missing required world_zone or invalid parameter
values
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
NavigationalStatusRequest:
type: object
required:
- navigational_status
properties:
navigational_status:
type: string
enum:
- under-way
- at-anchor
- drifting
- restricted
- constrained
- moored
- aground
- fishing
- sailing
description: >-
AIS navigational status. For drifting, constrained, and aground
statuses, world_zone is not required.
world_zone:
type: string
enum:
- 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
description: >-
Ocean/sea zone. Required unless navigational_status is drifting,
constrained, or aground.
vessel_type:
type: string
enum:
- 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
description: Filter by vessel type
laden:
type: string
enum:
- ballast
- partial
- laden
description: >-
Laden/ballast condition. ballast=0-49%, partial=50-75%,
laden=76-100%
for_order:
type: string
enum:
- 'true'
- 'false'
description: Whether vessel is sailing for orders
NavigationalStatusResponse:
type: object
properties:
vessels:
type: array
items:
type: object
properties:
imo:
type: string
description: IMO number
mmsi:
type: string
description: MMSI number
name:
type: string
description: Vessel name
country:
type: string
description: Country of registration
shipType:
type: string
description: Vessel type label
Error:
type: object
properties:
error:
type: string
description: Error type
message:
type: string
description: Error message
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-api-key
description: >-
Your personal API key found in your profile dashboard at
https://datadocked.com/dashboard/my_keys
````