> ## 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.
# Get Vessel Info
> Retrieve comprehensive vessel information including particulars, location, engine data, management details, and port history. Costs 5 credits per request. Rate limit: 15 requests/min.
Retrieve comprehensive vessel information including particulars, real-time location, engine specifications, management details, and port history in a single request.
**Credits:** 5 credits per request
## Response Fields
This endpoint returns the most complete vessel data available, including:
* **Identification**: IMO, MMSI, name, callsign, flag
* **Specifications**: Dimensions, tonnage, capacity, build info
* **Real-time Position**: Coordinates, speed, course, destination
* **Engine Data**: Type, builder, power, fuel type
* **Management**: Owner, manager, ISM, P\&I club, classification society
If you only need specific data (e.g., just location or particulars), consider using the dedicated endpoints to save credits.
## OpenAPI
````yaml GET /get-vessel-info
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-vessel-info:
get:
tags:
- Vessel Operations
summary: Get Vessel Info
description: >-
Retrieve comprehensive vessel information including particulars,
location, engine data, management details, and port history. Costs 5
credits per request. Rate limit: 15 requests/min.
operationId: getVesselInfo
parameters:
- name: imo_or_mmsi
in: query
required: true
description: The IMO or MMSI number of the vessel you want to query.
schema:
type: string
example: '9247431'
responses:
'200':
description: Successful response with vessel information
content:
application/json:
schema:
$ref: '#/components/schemas/VesselInfoResponse'
'400':
description: Bad request - Invalid IMO/MMSI format
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Vessel not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
VesselInfoResponse:
type: object
properties:
detail:
type: object
properties:
name:
type: string
description: Vessel name
mmsi:
type: string
description: Maritime Mobile Service Identity
imo:
type: string
description: IMO number
country:
type: string
description: Flag state
countryIso:
type: string
description: ISO country code
shipType:
type: string
description: General vessel type
typeSpecific:
type: string
description: Specific vessel type
callsign:
type: string
description: Radio call sign
teu:
type: string
description: TEU capacity
length:
type: string
description: Vessel length
beam:
type: string
description: Vessel beam/width
eni:
type: string
description: European Number of Identification
etaUtc:
type: string
description: Estimated time of arrival (UTC)
deadweight:
type: string
description: Deadweight tonnage
speed:
type: string
description: Current speed in knots
atdUtc:
type: string
description: Actual time of departure (UTC)
latitude:
type: string
description: Current latitude
longitude:
type: string
description: Current longitude
course:
type: string
description: Course over ground
destination:
type: string
description: Reported destination
hull:
type: string
description: Hull type
builder:
type: string
description: Shipyard/builder name
material:
type: string
description: Hull material
placeOfBuild:
type: string
description: Build location
positionReceived:
type: string
description: Last position update time
ballastWater:
type: string
description: Ballast water capacity
crudeOil:
type: string
description: Crude oil capacity
freshWater:
type: string
description: Fresh water capacity
gas:
type: string
description: Gas capacity
grain:
type: string
description: Grain capacity
bale:
type: string
description: Bale capacity
unlocodeDestination:
type: string
description: UN/LOCODE of destination
unlocodeLastport:
type: string
description: UN/LOCODE of last port
lastPort:
type: string
description: Last port name
navigationalStatus:
type: string
description: AIS navigational status
grossTonnage:
type: string
description: Gross tonnage
netTonnage:
type: string
description: Net tonnage
yearOfBuilt:
type: string
description: Year built
engine:
$ref: '#/components/schemas/EngineData'
management:
$ref: '#/components/schemas/ManagementData'
updateTime:
type: string
description: Data update timestamp
dataSource:
type: string
description: AIS data source (Terrestrial/Satellite)
Error:
type: object
properties:
error:
type: string
description: Error type
message:
type: string
description: Error message
EngineData:
type: object
properties:
fuelType:
type: string
description: Fuel type
Propeller:
type: string
description: Propeller details
engineType:
type: string
description: Engine model
engineBuilder:
type: string
description: Engine manufacturer
enginePower(kW):
type: string
description: Engine power in kW
ManagementData:
type: object
properties:
P&I:
type: string
description: P&I club information
ism:
type: string
description: ISM manager
ismWeb:
type: string
description: ISM manager website
manager:
type: string
description: Ship manager
ismEmail:
type: string
description: ISM manager email
ismAddress:
type: string
description: ISM manager address
ismWebsite:
type: string
description: ISM manager website
managerEmail:
type: string
description: Manager email
managerAddress:
type: string
description: Manager address
managerWebsite:
type: string
description: Manager website
registeredOwner:
type: string
description: Registered owner
registeredOwnerEmail:
type: string
description: Owner email
ClassificationSociety:
type: string
description: Classification society
registeredOwnerAddress:
type: string
description: Owner address
registeredOwnerWebsite:
type: string
description: Owner website
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
````