Data Docked

API Documentation

Welcome to the Data Docked API!

The Data Docked API provides detailed information about vessels by utilizing their IMO or MMSI numbers. This guide will help you get started quickly and effectively, with examples in various programming languages.

Getting Started

Step 1: Register

Create an account on our platform at datadocked.com.

Step 2: Verify Your Email

Activate your account by clicking the verification link sent to your registered email.

Step 3: Generate Your API Key

Making Requests

Endpoint

GET https://datadocked.com/api/vessels_operations/get-vessel-info

Required Parameters:

api_key (required):
Your personal API key, found in your profile dashboard
imo_or_mmsi (required):
The IMO or MMSI number of the vessel you want to query.

Example Request:

https://datadocked.com/api/vessels_operations/get-vessel-info?api_key=YOUR_API_KEY&imo_or_mmsi=VESSEL_IMO_OR_MMSI_NUMBER

My credits

Endpoint

GET https://datadocked.com/api/vessels_operations/my_credits

Required Parameters:

api_key (required):
Your personal API key, found in your profile dashboard

Example Request:

https://datadocked.com/api/vessels_operations/my_credits?api_key=YOUR_API_KEY

Response Format

The API responds with a JSON object containing detailed vessel information:

Sample JSON Response:

{
  "detail": {
	"vesselInfo": {
	  "name": "MSC AMELIA",
	  "mmsi": "636020543",
	  "imo": "9896995",
	  "countryIso": "LR",
	  "country": "Liberia",
	  "shipType": "Cargo vessels",
	  "typeSpecific": "Container Ship",
	  "navigationalStatus": "Under way",
	  "callsign": "D5ZR4",
	  "grossTonnage": "228786",
	  "length": "400 m",
	  "beam": "61 m",
	  "yearOfBuilt": "2021",
	  "currentDraught": "12.6 m",
	  "deadweight": "255288",
	  "latitude": "-22.76091",
	  "longitude": "12.65094",
	  "destination": "Singapore",
	  "engine": {
        "fuelType": "DIESEL/GAS TURBINE",
        "Propeller": "1 SCREW PROPELLER CONTROLLABLE PITCH LB (OIL -CLOSED)",
        "engineType": "(2) 4T - 6 CYL - 500 MM X 580 MM AT 514 RPM",
        "engineBuilder": "Wärtsilä",
        "enginePower(kW)": "6468"},
      "ports": [
        {
          "arrived": "May 28, 07:27",
          "departed": "May 29, 14:17",
          "portName": "Stenungsund Sweden",
          "portSign": "SESTE001"
        },
        {
          "arrived": "May 27, 09:26",
          "departed": "May 27, 11:52",
          "portName": "Stenungsund Anch. Sweden",
          "portSign": "SESTE001"
        }],
	  "lastPort": "Ashdod, Israel",
      "management":{
          "ClassificationSociety": "DNV GL",
          "P&I": "Assuranceforeningen Gard - Norway (inception 2025-04-20)",
          "ism": "ALTERA INFRASTRUCTURE NORWAY",
          "ismAddress": "Badehusgata 37, 4014, Stavanger, Norway.",
          "ismEmail": "[email protected]",
          "ismWeb": "http://www.alterainfra.com",
          "manager": "ALTERA INFRASTRUCTURE NORWAY",
          "managerAddress": "Badehusgata 37, 4014, Stavanger, Norway.",
          "registeredOwner": "HAI KUO SHIPPING 1959T LTD"
          }
	  "eni": null,
	  "etaUtc": null,
	  "draught": "4.6 / max: 6.2",
      "speed": "0.5 kn.",
	  "atdUtc": "ATD: Jun 17, 23:18 UTC (2 days ago)",
	  "course": "276.1"
	}
  }
}

List of Values

We provide the opportunity for you to receive: name, mmsi, imo, countryIso, country, shipType, typeSpecific, navigationalStatus, callsign, grossTonnage, length, beam, yearOfBuilt, currentDraught, deadweight, latitude, longitude, destination, engine, ports, lastPort, eni, etaUtc, draught, speed, atdUtc, course.

Common Responses:

200 OK:
The request was successful, and vessel details are returned
404 Not Found:
The vessel information could not be found

Code Examples

import requests
import json

api_key = 'YOUR_API_KEY'
imo_or_mmsi = 'VESSEL_IMO_OR_MMSI_NUMBER'
url = f"https://datadocked.com/api/vessels_operations/get-vessel-info?api_key={api_key}&imo_or_mmsi={imo_or_mmsi}"

response = requests.get(url)
if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}, {response.text}")

Support

If you need help or have any questions, please don't hesitate to contact us at [email protected].