Data DockedSIGN IN / SIGN UP

API Documentation

Quick Start

Start testing our vessel data API immediately or follow our comprehensive setup guide to get started.

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

Log in to your account, navigate to your profile dashboard, and generate your unique API key.

📖 API Reference

Complete documentation for all available endpoints. Each section includes parameters, examples, and sample responses.

💳

API Credit Costs

Each API call consumes credits based on the data complexity and processing requirements:

5 creditsVessel Info (comprehensive vessel data)
3 creditsVessel Inspection Data (detailed inspection records)
1 creditAll other endpoints (location, particulars, engine data, etc.)
VariablePort Calls by Port (depends on offset parameter)

Common Responses

  • 200 OK

    Request was successful

  • 400 Bad Request

    Invalid request parameters or malformed request

  • 401 Unauthorized

    Invalid or missing API key

  • 403 Forbidden

    Access denied or insufficient credits

  • 404 Not Found

    Vessel not found or endpoint does not exist

  • 429 Too Many Requests

    Rate limit exceeded

  • 500 Internal Server Error

    Server error occurred

My Credits

💳 0 credits
Endpoint
GET https://datadocked.com/api/vessels_operations/my_credits
Required Parameters
  • api_key: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": "99929 credits left."
}
Available Fields
detail

Get Vessel Info

💳 5 credits
View Documentation
Endpoint
GET https://datadocked.com/api/vessels_operations/get-vessel-info
Required Parameters
  • api_key:Your personal API key, found in your profile dashboard
  • imo_or_mmsi: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

Response Format

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

Sample JSON Response
{
  "detail": {
    "name": "LAURANA",
    "mmsi": "247342000",
    "imo": "9011014",
    "country": "Italy",
    "shipType": "Miscellaneous",
    "callsign": "ICEL",
    "teu": "",
    "length": "122 m",
    "beam": "20 m",
    "eni": null,
    "image": "https://static.vesselfinder.net/ship-photo/9011014-247342000-672d4d9a1223ae7b65c7d90997ca8641/1?v1",
    "etaUtc": "Oct 01, 2025 10:15 UTC",
    "draught": "4.8 m. ( max 4.8)",
    "deadweight": "2328",
    "speed": "0.0",
    "atdUtc": "Sep 30, 2025 18:25 UTC",
    "latitude": "38.21558",
    "longitude": "15.24491",
    "course": "307.0",
    "destination": "ITMLZ",
    "hull": "SINGLE HULL",
    "builder": "FINCANTIERI PALERMO",
    "material": "STEEL/ORDINARY",
    "placeOfBuild": "PALERMO, Italy",
    "positionReceived": "Oct 02, 2025 08:27 UTC",
    "ballastWater": "0",
    "crudeOil": "0",
    "freshWater": "0",
    "gas": "0 m³",
    "grain": "0 m³",
    "bale": "0 m³",
    "unlocode_destination": "ITMLZ",
    "unlocode_lastport": "ITNAP",
    "lastPort": "Napoli, Italy",
    "countryIso": "IT",
    "typeSpecific": "Passenger/Ro-Ro Cargo Ship",
    "navigationalStatus": "Moored",
    "grossTonnage": "11193",
    "yearOfBuilt": "1992",
    "currentDraught": "4.8 m",
    "engine": {
      "engineBuilder": "GRANDI MOTORI",
      "engineType": "A420.6L",
      "enginePower(kW)": "7060",
      "fuelType": "MARINE DIESEL",
      "Propeller": "2 CONTROLLABLE PITCH"
    },
    "ports": [
      {
        "portName": "Milazzo Italy",
        "portSign": "ITMLZ",
        "arrived": "Oct 1, 10:40",
        "departed": "-"
      },
      {
        "portName": "Napoli Italy",
        "portSign": "ITNAP",
        "arrived": "Sep 30, 05:55",
        "departed": "Sep 30, 18:25"
      },
      {
        "portName": "Lipari Italy",
        "portSign": "ITLIP",
        "arrived": "Sep 29, 14:40",
        "departed": "Sep 29, 15:19"
      }
    ],
    "management": {
      "registeredOwner": "CARONTE & TOURIST ISOLE MINORI",
      "registeredOwnerAddress": "Via Ingegnere Giuseppe Franza 82, 98124, Messina ME, Italy.",
      "registeredOwnerWebsite": "http://www.carontetourist.it/",
      "registeredOwnerEmail": "[email protected], [email protected]",
      "manager": "CARONTE & TOURIST ISOLE MINORI",
      "ismAddress": "Via Ingegnere Giuseppe Franza 82, 98124, Messina ME, Italy.",
      "managerAddress": "Via Ingegnere Giuseppe Franza 82, 98124, Messina ME, Italy.",
      "managerWebsite": "http://www.carontetourist.it/",
      "managerEmail": "[email protected], [email protected]",
      "ism": "CARONTE & TOURIST ISOLE MINORI",
      "ismWeb": "http://www.carontetourist.it/",
      "ismWebsite": "http://www.carontetourist.it/",
      "ismEmail": "[email protected], [email protected]",
      "P&I": "-",
      "ClassificationSociety": "REGISTRO ITALIANO NAVALE"
    },
    "updateTime": "Oct 02, 2025 08:30 UTC"
  }
}
Available Fields
name, mmsi, imo, country, countryIso, shipType, typeSpecific, callsign, teu, length, beam, eni, image, etaUtc, draught, deadweight, speed, atdUtc, latitude, longitude, course, destination, hull, builder, material, placeOfBuild, positionReceived, ballastWater, crudeOil, freshWater, gas, grain, bale, unlocode_destination, unlocode_lastport, lastPort, navigationalStatus, grossTonnage, yearOfBuilt, currentDraught, engine, engine.engineBuilder, engine.engineType, engine.enginePower(kW), engine.fuelType, engine.Propeller, ports, ports.portName, ports.portSign, ports.arrived, ports.departed, management, management.registeredOwner, management.registeredOwnerAddress, management.registeredOwnerWebsite, management.registeredOwnerEmail, management.manager, management.ismAddress, management.managerAddress, management.managerWebsite, management.managerEmail, management.ism, management.ismWeb, management.ismWebsite, management.ismEmail, management.P&I, management.ClassificationSociety, updateTime

Get Vessel Particulars

💳 1 credit
Endpoint
GET https://datadocked.com/api/vessels_operations/get-vessel-particulars
Required Parameters
  • api_key:Your personal API key, found in your profile dashboard
  • imo_or_mmsi:The IMO or MMSI number of the vessel you want to query.
Example Request
https://datadocked.com/api/vessels_operations/get-vessel-particulars?api_key=YOUR_API_KEY&imo_or_mmsi=VESSEL_IMO_OR_MMSI_NUMBER

Response Format

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

Sample JSON Response
{
  "detail": {
    "name": "LAURANA",
    "imo": "9011014",
    "mmsi": "247342000",
    "countryIso": "IT",
    "country": "Italy",
    "image": "https://static.vesselfinder.net/ship-photo/9011014-247342000-672d4d9a1223ae7b65c7d90997ca8641/1?v1",
    "shipType": "Miscellaneous",
    "typeSpecific": "Passenger/Ro-Ro Cargo Ship",
    "grossTonnage": "11193",
    "teu": "",
    "length": "122 m",
    "beam": "20 m",
    "yearOfBuilt": "1992",
    "currentDraught": "4.8 m",
    "eni": null,
    "deadweight": "2328",
    "updateTime": "Oct 02, 2025 09:25 UTC",
    "bale": "0 m³",
    "hull": "SINGLE HULL",
    "ballastWater": "0",
    "freshWater": "0",
    "crudeOil": "0",
    "gas": "0 m³",
    "grain": "0 m³",
    "builder": "FINCANTIERI PALERMO",
    "material": "STEEL/ORDINARY",
    "placeOfBuild": "PALERMO, Italy"
  }
}
Available Fields
name, imo, mmsi, countryIso, country, image, shipType, typeSpecific, grossTonnage, teu, length, beam, yearOfBuilt, currentDraught, eni, deadweight, updateTime, bale, hull, ballastWater, freshWater, crudeOil, gas, grain, builder, material, placeOfBuild

Get Vessel Location

💳 1 credit
Endpoint
GET https://datadocked.com/api/vessels_operations/get-vessel-location
Required Parameters
  • api_key:Your personal API key, found in your profile dashboard
  • imo_or_mmsi:The IMO or MMSI number of the vessel you want to query.
Example Request
https://datadocked.com/api/vessels_operations/get-vessel-location?api_key=YOUR_API_KEY&imo_or_mmsi=VESSEL_IMO_OR_MMSI_NUMBER

Response Format

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

Sample JSON Response
{
  "detail": {
    "name": "LAURANA",
    "imo": "9011014",
    "mmsi": "247342000",
    "latitude": "38.21559",
    "longitude": "15.24492",
    "etaUtc": "Oct 01, 2025 10:15 UTC",
    "atdUtc": "Sep 30, 2025 18:25 UTC",
    "course": "230.0",
    "speed": "0.0",
    "draught": "4.8 m. ( max 4.8)",
    "navigationalStatus": "Moored",
    "destination": "ITMLZ",
    "lastPort": "Napoli, Italy",
    "callsign": "ICEL",
    "positionReceived": "Oct 02, 2025 09:24 UTC",
    "updateTime": "Oct 02, 2025 09:30 UTC",
    "unlocode_destination": "ITMLZ",
    "unlocode_lastport": "ITNAP"
  }
}
Available Fields
name, imo, mmsi, latitude, longitude, etaUtc, atdUtc, course, speed, draught, navigationalStatus, destination, lastPort, callsign, positionReceived, updateTime, unlocode_destination, unlocode_lastport