> ## 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.
# Vessel Inspection Data
> Retrieve comprehensive vessel inspection data including Port State Control (PSC) inspections, classification surveys, certificates, P&I information, and ship history. Costs 3 credits per request. Rate limit: 15 requests/min.
Retrieve comprehensive vessel inspection data including Port State Control (PSC) inspections, classification surveys, certificates, P\&I information, and ship history.
**Credits:** 3 credits per request
## Response Data
### Specifications
Basic vessel particulars including vessel name, flag, call sign, tonnage, type, status, and last update timestamp.
### Classification
* Current classification status (society, status, since)
* Survey history with last/next renewal dates and external links to the classification society's record
### Certificates
Class certificates with full status tracking:
* `classification_society` — Issuing classification society
* `date_survey` — Survey date
* `date_expiry` — Expiry date
* `date_change_status` — Date the status last changed
* `status` — Certificate status (e.g. `Delivered`, `Withdrawn`)
* `reason` — Reason for status change (e.g. `"company's request for other reasons"`)
* `top_cv` — Certificate category (e.g. `Convention`)
### P\&I Information
Protection and Indemnity insurance details with insurer name and inception date.
### Movements
Historical movement records showing areas where the vessel has been observed (date and area).
### Inspections
Port State Control inspection records. Each inspection has summary fields plus a `detailed_info` block:
**Summary fields:** `authority`, `port_of_inspection`, `date_of_report`, `detention` (Y/N), `psc_organisation`, `type_of_inspection`, `duration_days`, `number_of_deficiencies`, `inspection_id`.
**`detailed_info` breakdown:**
* `port_state` — PSC summary (organisation, authority, port, type, date, detention, deficiency count; `Duration (days)` is also included when the vessel was detained)
* `particulars` — Vessel snapshot at the time of inspection (IMO, name, call sign, tonnage, type, year of build)
* `classification` — Class snapshot at the time of inspection (class, last survey, status)
* `statutory` — Statutory certificates with issue/expiry dates and Recognized Organisation/Flag
* `deficiencies` — Deficiencies grouped by category, with description and total count
* `grounds_for_detention` — Populated only when `detention: "Y"`. Each entry includes the category, deficiency, defect type (e.g. `Invalid`, `Inoperative`, `Lack of training`), count, and whether it is class-related
### Ship History
* Former names and flags
* Classification renewal history
* Company role changes over time
This endpoint requires an **IMO number** (not MMSI).
## OpenAPI
````yaml GET /vessel-mou
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:
/vessel-mou:
get:
tags:
- Vessel Operations
summary: Vessel Inspection Data
description: >-
Retrieve comprehensive vessel inspection data including Port State
Control (PSC) inspections, classification surveys, certificates, P&I
information, and ship history. Costs 3 credits per request. Rate limit:
15 requests/min.
operationId: getVesselInspectionData
parameters:
- name: imo
in: query
required: true
description: The IMO number of the vessel you want to query.
schema:
type: string
example: '9184419'
responses:
'200':
description: Successful response with inspection data
content:
application/json:
schema:
$ref: '#/components/schemas/VesselInspectionResponse'
'400':
description: Bad request - Invalid IMO 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'
components:
schemas:
VesselInspectionResponse:
type: object
properties:
status_code:
type: integer
detail:
type: object
properties:
specs:
type: object
properties:
Flag:
type: string
Call Sign:
type: string
MMSI:
type: string
Gross tonnage:
type: string
DWT:
type: string
Type of ship:
type: string
Year of build:
type: string
Status:
type: string
last_update:
type: string
name:
type: string
description: Vessel name
classification:
type: object
properties:
status:
type: object
properties:
society:
type: string
status:
type: string
since:
type: string
surveys:
type: array
items:
type: object
properties:
society:
type: string
last_renewal:
type: string
next_renewal:
type: string
external_url:
type: string
certificates:
type: array
items:
type: object
properties:
classification_society:
type: string
description: Classification society name
date_survey:
type: string
description: Survey date (dd/mm/yyyy)
date_expiry:
type: string
description: Expiry date (dd/mm/yyyy)
date_change_status:
type: string
description: Date status was last changed (dd/mm/yyyy)
status:
type: string
description: Certificate status (e.g. Delivered, Withdrawn)
reason:
type: string
description: Reason for status change
top_cv:
type: string
description: Certificate category (e.g. Convention)
pi_info:
type: array
items:
type: object
properties:
insurer:
type: string
inception:
type: string
movements:
type: array
items:
type: object
properties:
date_record:
type: string
area_seen:
type: string
inspection:
type: array
items:
type: object
properties:
authority:
type: string
port_of_inspection:
type: string
date_of_report:
type: string
detention:
type: string
description: Y or N
psc_organisation:
type: string
type_of_inspection:
type: string
duration_days:
type: string
description: Inspection duration in days (populated when detained)
number_of_deficiencies:
type: string
inspection_id:
type: string
detailed_info:
type: object
description: Detailed inspection breakdown
properties:
port_state:
type: object
properties:
PSC Organisation:
type: string
Authority:
type: string
Port of inspection:
type: string
Type of inspection:
type: string
Date of report:
type: string
Detention:
type: string
description: Yes or No
Duration (days):
type: string
description: Present only when vessel was detained
Number of deficiencies:
type: string
particulars:
type: object
description: Vessel particulars at the time of inspection
properties:
IMO number:
type: string
Name of ship:
type: string
Call Sign:
type: string
Gross tonnage:
type: string
Type of ship:
type: string
Year of build:
type: string
classification:
type: object
description: Classification snapshot at the time of inspection
properties:
Class:
type: string
Last survey:
type: string
Status:
type: string
statutory:
type: array
description: Statutory certificates valid at time of inspection
items:
type: object
properties:
certificate:
type: string
description: Certificate name
ro_flag:
type: string
description: Recognized Organisation or Flag
issue_date:
type: string
description: Issue date (yyyy-mm-dd)
expiry_date:
type: string
description: Expiry date (yyyy-mm-dd), empty if none
deficiencies:
type: array
description: Deficiencies found during inspection
items:
type: object
properties:
category:
type: string
description: Deficiency category
deficiency:
type: string
description: Specific deficiency description
defect:
type: string
total:
type: string
description: Number of items in this category
grounds_for_detention:
type: array
description: Reasons for vessel detention. Empty when not detained.
items:
type: object
properties:
category:
type: string
description: Detention ground category
deficiency:
type: string
description: Specific deficiency description
defect:
type: string
description: >-
Defect type (e.g. Invalid, Inoperative, Lack of
training)
number:
type: string
description: Count of items
class_related_deficiency:
type: string
description: Whether class-related (Yes/No)
ship_history:
type: object
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
````