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": {
    "id": 86,
    "name": "EXCELSIOR",
    "mmsi": "247351100",
    "imo": "9184419",
    "countryIso": "IT",
    "country": "Italy",
    "image": "https://static.vesselfinder.net/ship-photo/9184419-247351100-e3f4a8585e7867f8f5b68c5ab8d302da/1?v1",
    "shipType": "Miscellaneous",
    "engine": [
      {
        "fuelType": "MARINE DIESEL",
        "Propeller": "2 CONTROLLABLE PITCH",
        "engineType": "UNEX G-201",
        "engineBuilder": "WARTSILA, VAASA FINLAND",
        "enginePower(kW)": "28960"
      }
    ],
    "ports": [
      [
        {
          "arrived": "Aug 31, 12:23",
          "departed": "Aug 31, 16:01",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 30, 05:44",
          "departed": "Aug 30, 18:02",
          "portName": "Genova Italy",
          "portSign": "ITGOA"
        },
        {
          "arrived": "Aug 29, 05:07",
          "departed": "Aug 29, 09:07",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        }
      ]
    ],
    "typeSpecific": "Passenger/Ro-Ro Cargo Ship",
    "navigationalStatus": "Under way",
    "callsign": "IBEX",
    "grossTonnage": "40502",
    "teu": "-",
    "length": "202 m",
    "beam": "27 m",
    "yearOfBuilt": "1999",
    "currentDraught": "6.6 m",
    "eni": null,
    "etaUtc": "ETA: Sep 01, 17:30  (in 22 hours)",
    "draught": "6.6 m (max 6.9)",
    "deadweight": "7300",
    "speed": "20.8 kn",
    "atdUtc": "ATD: Aug 31, 16:01 UTC  (4 hours ago)",
    "latitude": "40.20278",
    "longitude": "1.43964",
    "course": "208.4°",
    "destination": "Barcelona, Spain",
    "lastPort": "Barcelona, Spain",
    "management": {
      "P&I": "Steamship Mutual Underwriting Association (Bermuda) (inception 2025-06-20)",
      "ism": "GRANDI NAVI VELOCI SPA",
      "ismWeb": "http://www.gnv.it",
      "manager": "GRANDI NAVI VELOCI SPA",
      "ismEmail": "[email protected]",
      "ismAddress": "Via Fieschi 17-17A, 16121, Genoa GE, Italy.",
      "ismWebsite": "http://www.gnv.it",
      "managerEmail": "[email protected]",
      "managerAddress": "Via Fieschi 17-17A, 16121, Genoa GE, Italy.",
      "managerWebsite": "http://www.gnv.it",
      "registeredOwner": "GRANDI NAVI VELOCI SPA",
      "registeredOwnerEmail": "[email protected]",
      "ClassificationSociety": "REGISTRO ITALIANO NAVALE",
      "registeredOwnerAddress": "Via Fieschi 17-17A, 16121, Genoa GE, Italy.",
      "registeredOwnerWebsite": "http://www.gnv.it"
    },
    "updateTime": "2025-08-31T19:46:58.400876",
    "positionReceived": "1 min ago",
    "unlocode_lastport": "ESBCN",
    "unlocode_destination": "ESBCN"
  }
}
Available Fields
id, name, mmsi, imo, countryIso, country, image, shipType, engine, fuelType, Propeller, engineType, engineBuilder, enginePower(kW), ports, arrived, departed, portName, portSign, typeSpecific, navigationalStatus, callsign, grossTonnage, teu, length, beam, yearOfBuilt, currentDraught, eni, etaUtc, draught, deadweight, speed, atdUtc, latitude, longitude, course, destination, lastPort, management, P&I, ism, ismWeb, manager, ismEmail, ismAddress, ismWebsite, managerEmail, managerAddress, managerWebsite, registeredOwner, registeredOwnerEmail, ClassificationSociety, registeredOwnerAddress, registeredOwnerWebsite, positionReceived, updateTime, unlocode_lastport, unlocode_destination

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": {
    "id": 999,
    "name": "UTOPIA OF THE SEAS",
    "mmsi": "311001259",
    "imo": "9880001",
    "countryIso": "ZZ",
    "country": "Atlantis",
    "image": "https://static.vesselfinder.net/ship-photo/9880001-311001259-131a17940eb7444897f79198c133e2cb/1?v1",
    "shipType": "Research Vessel",
    "typeSpecific": "Oceanographic Survey Ship",
    "grossTonnage": "98765",
    "teu": "5000",
    "length": "300 m",
    "beam": "45 m",
    "yearOfBuilt": "2020",
    "currentDraught": "12.3 m",
    "eni": "99999999",
    "deadweight": "87654",
    "updateTime": "2025-07-30T10:52:14.227527"
  }
}
Available Fields
id, name, mmsi, imo, countryIso, country, image, shipType, typeSpecific, grossTonnage, teu, length, beam, yearOfBuilt, currentDraught, eni, deadweight, updateTime

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": "EXCELSIOR",
    "imo": "9184419",
    "mmsi": "247351100",
    "latitude": "40.19767",
    "longitude": "1.43605",
    "etaUtc": "ETA: Sep 01, 17:30  (in 22 hours)",
    "atdUtc": "ATD: Aug 31, 16:01 UTC  (4 hours ago)",
    "course": "207.9°",
    "speed": "20.8 kn",
    "draught": "6.6 m (max 6.9)",
    "navigationalStatus": "Under way",
    "destination": "Barcelona, Spain",
    "lastPort": "Barcelona, Spain",
    "callsign": "IBEX",
    "positionReceived": "2 min ago",
    "updateTime": "2025-08-31T19:49:18.594485",
    "unlocode_destination": "ESBCN",
    "unlocode_lastport": "ESBCN"
  }
}
Available Fields
name, imo, mmsi, latitude, longitude, etaUtc, atdUtc, course, speed, draught, navigationalStatus, destination, lastPort, callsign, positionReceived, updateTime, unlocode_destination, unlocode_lastport

Get Vessel Engine Data

💳 1 credit
Endpoint
GET https://datadocked.com/api/vessels_operations/get-vessel-engine-data
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-engine-data?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": {
    "engine": [
      {
        "name": "UTOPIA OF THE SEAS",
        "imo":"9880001",
        "mmsi":"311001259",
        "fuelType": "Synthetic Biofuel",
        "Propeller": "2 VARIABLE PITCH",
        "engineType": "NEO-DRIVE X200",
        "engineBuilder": "AQUATech Marine Systems",
        "enginePower(kW)": "84500"
      }
    ]
  }
}
Available Fields
engine, engine.fuelType, engine.Propeller, engine.engineType, engine.engineBuilder, engine.enginePower(kW)

Get Vessel Management Data

💳 1 credit
Endpoint
GET https://datadocked.com/api/vessels_operations/get-vessel-management-data
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-management-data?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": "EXCELSIOR",
    "imo": "9184419",
    "mmsi": "247351100",
    "management": {
      "P&I": "Steamship Mutual Underwriting Association (Bermuda) (inception 2025-06-20)",
      "ism": "GRANDI NAVI VELOCI SPA",
      "ismWeb": "http://www.gnv.it",
      "manager": "GRANDI NAVI VELOCI SPA",
      "ismEmail": "[email protected]",
      "ismAddress": "Via Fieschi 17-17A, 16121, Genoa GE, Italy.",
      "ismWebsite": "http://www.gnv.it",
      "managerEmail": "[email protected]",
      "managerAddress": "Via Fieschi 17-17A, 16121, Genoa GE, Italy.",
      "managerWebsite": "http://www.gnv.it",
      "registeredOwner": "GRANDI NAVI VELOCI SPA",
      "registeredOwnerEmail": "[email protected]",
      "ClassificationSociety": "REGISTRO ITALIANO NAVALE",
      "registeredOwnerAddress": "Via Fieschi 17-17A, 16121, Genoa GE, Italy.",
      "registeredOwnerWebsite": "http://www.gnv.it"
    }
  }
}
Available Fields
name, imo, mmsi, management, P&I, ism, ismWeb, manager, ismEmail, ismAddress, ismWebsite, managerEmail, managerAddress, managerWebsite, registeredOwner, registeredOwnerEmail, ClassificationSociety, registeredOwnerAddress, registeredOwnerWebsite

Port Calls By Vessel

💳 1 credit
Endpoint
GET https://datadocked.com/api/vessels_operations/port-calls-by-vessel
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/port-calls-by-vessel?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": "EXCELSIOR",
    "imo": "9184419",
    "mmsi": "247351100",
    "ports": [
      [
        {
          "arrived": "Aug 31, 12:23",
          "departed": "Aug 31, 16:01",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 30, 05:44",
          "departed": "Aug 30, 18:02",
          "portName": "Genova Italy",
          "portSign": "ITGOA"
        },
        {
          "arrived": "Aug 29, 05:07",
          "departed": "Aug 29, 09:07",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 27, 17:46",
          "departed": "Aug 28, 00:52",
          "portName": "Tanger Med Morocco",
          "portSign": "MAPTM"
        },
        {
          "arrived": "Aug 25, 18:12",
          "departed": "Aug 25, 23:52",
          "portName": "Genova Italy",
          "portSign": "ITGOA"
        },
        {
          "arrived": "Aug 24, 20:43",
          "departed": "Aug 24, 23:57",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 23, 13:11",
          "departed": "Aug 23, 19:59",
          "portName": "Tanger Med Morocco",
          "portSign": "MAPTM"
        },
        {
          "arrived": "Aug 22, 09:07",
          "departed": "Aug 22, 11:59",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 21, 05:10",
          "departed": "Aug 21, 15:28",
          "portName": "Genova Italy",
          "portSign": "ITGOA"
        },
        {
          "arrived": "Aug 20, 06:32",
          "departed": "Aug 20, 09:42",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 18, 20:34",
          "departed": "Aug 19, 03:17",
          "portName": "Tanger Med Morocco",
          "portSign": "MAPTM"
        },
        {
          "arrived": "Aug 17, 14:59",
          "departed": "Aug 17, 19:06",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 16, 16:28",
          "departed": "Aug 16, 22:58",
          "portName": "Genova Italy",
          "portSign": "ITGOA"
        },
        {
          "arrived": "Aug 15, 21:47",
          "departed": "Aug 15, 23:27",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 14, 12:25",
          "departed": "Aug 14, 20:13",
          "portName": "Tanger Med Morocco",
          "portSign": "MAPTM"
        }
      ]
    ]
  }
}
Available Fields
name, imo, mmsi, ports, arrived, departed, portName, portSign

Port Calls By Port

Depends on offset
View Documentation
Endpoint
GET https://datadocked.com/api/vessels_operations/port-calls-by-port
Required Parameters
  • api_key:Your personal API key, found in your profile dashboard
  • port_call:The port call you want to query.
  • offset:The number of vessels you want to receive.
  • search_type:The type of search, can be: arrival, departures,expected or in_port.
Example Request
https://datadocked.com/api/vessels_operations/port-calls-by-port?api_key=YOUR_API_KEY&port_call=PORT_CALL&offset=10&search_type=SEARCH_TYPE

Response Format

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

Sample JSON Response
{
  "status_code": 200,
  "detail": {
    "arrival": {
      "total": 3923,
      "pages": 4,
      "list": [
        {
          "mmsi": 225903360,
          "name": "FLY BLUE DOS",
          "imo": 0,
          "type": "Passenger ship",
          "year": 0,
          "country": "Spain",
          "a2": "es",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "22 x 11",
          "next": null,
          "formattedETA": "Aug 31, 20:50",
          "prev": null
        },
        {
          "mmsi": 224083520,
          "name": "ESTRELLA Y MANUEL",
          "imo": 0,
          "type": "Other type",
          "year": 0,
          "country": "Spain",
          "a2": "es",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "17 x 6",
          "next": null,
          "formattedETA": "Aug 31, 20:42",
          "prev": {
            "rpzone": {
              "name": "Motril",
              "a2": "es",
              "lat": 36.71016221476279,
              "lon": -3.509702682495117,
              "pk": "ESMOT001"
            },
            "rpdna": "Motril",
            "rpdco": "Spain",
            "rpdatd": 1755613951,
            "rpdid": "ESMOT001",
            "rpdtt": "ATD",
            "rpda2": "es",
            "rpdst": 1
          }
        },
        {
          "mmsi": 225988036,
          "name": "BIG FISH I",
          "imo": 0,
          "type": "Pleasure craft",
          "year": 0,
          "country": "Spain",
          "a2": "es",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "12 x 6",
          "next": null,
          "formattedETA": "Aug 31, 20:42",
          "prev": {
            "rpzone": {
              "name": "Palamos",
              "a2": "es",
              "lat": 41.833300000000094,
              "lon": 3.116669999999983,
              "pk": "ESPAL001"
            },
            "rpdna": "Palamos",
            "rpdco": "Spain",
            "rpdatd": 1751098701,
            "rpdid": "ESPAL001",
            "rpdtt": "ATD",
            "rpda2": "es",
            "rpdst": 1
          }
        },
        {
          "mmsi": 227895860,
          "name": "MIKENO VI",
          "imo": 0,
          "type": "Sailing vessel",
          "year": 0,
          "country": "France",
          "a2": "fr",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "-",
          "next": null,
          "formattedETA": "Aug 31, 20:41",
          "prev": null
        },
        {
          "mmsi": 255915808,
          "name": "FAMILY",
          "imo": 0,
          "type": "Pleasure craft",
          "year": 0,
          "country": "Portugal (Madeira)",
          "a2": "xb",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "23 x 6",
          "next": null,
          "formattedETA": "Aug 31, 20:39",
          "prev": {
            "rpzone": {
              "name": "Cannes",
              "a2": "fr",
              "lat": 43.53289089623931,
              "lon": 6.992239526418352,
              "pk": "FRCEQ001"
            },
            "rpdna": "Cannes",
            "rpdco": "France",
            "rpdatd": 1755847307,
            "rpdid": "FRCEQ001",
            "rpdtt": "ATD",
            "rpda2": "fr",
            "rpdst": 1
          }
        },
        {
          "mmsi": 256004198,
          "name": "TAPIOCA",
          "imo": 0,
          "type": "Sailing vessel",
          "year": 0,
          "country": "Malta",
          "a2": "mt",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "20 x 6",
          "next": null,
          "formattedETA": "Aug 31, 20:33",
          "prev": {
            "rpzone": {
              "name": "Palma de Mallorca",
              "a2": "es",
              "lat": 39.55430000000021,
              "lon": 2.64775,
              "pk": "ESPMI001"
            },
            "rpdna": "Palma de Mallorca",
            "rpdco": "Spain",
            "rpdatd": 1756608043,
            "rpdid": "ESPMI001",
            "rpdtt": "ATD",
            "rpda2": "es",
            "rpdst": 1
          }
        },
        {
          "mmsi": 225988697,
          "name": "NEMO NEFES",
          "imo": 0,
          "type": "Sailing vessel",
          "year": 0,
          "country": "Spain",
          "a2": "es",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "10 x 4",
          "next": null,
          "formattedETA": "Aug 31, 20:31",
          "prev": null
        },
        {
          "mmsi": 225995705,
          "name": "ALMA EXPLORER YACHTS",
          "imo": 0,
          "type": "Pleasure craft",
          "year": 0,
          "country": "Spain",
          "a2": "es",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "33 x 8",
          "next": null,
          "formattedETA": "Aug 31, 20:30",
          "prev": null
        },
        {
          "mmsi": 225998877,
          "name": "JEANNOT III",
          "imo": 0,
          "type": "Pleasure craft",
          "year": 0,
          "country": "Spain",
          "a2": "es",
          "gt": 0,
          "dw": 0,
          "sa": true,
          "tlck": 1,
          "sizes": "12 x 4",
          "next": null,
          "formattedETA": "Aug 31, 20:09",
          "prev": null
        },
        {
          "mmsi": 538011785,
          "name": "GULF PETROLEUM 4",
          "imo": 9439345,
          "type": "Chemical/Oil Products Tanker",
          "year": 2009,
          "country": "Marshall Islands",
          "a2": "mh",
          "gt": 8539,
          "dw": 13006,
          "sa": true,
          "tlck": 1,
          "sizes": "129 x 23",
          "next": null,
          "formattedETA": "Aug 31, 20:00",
          "prev": {
            "rpzone": {
              "name": "Rotterdam Vondeling",
              "a2": "nl",
              "lat": 51.893033530457416,
              "lon": 4.342174530029297,
              "pk": "NLZBW001"
            },
            "rpdna": "Rotterdam Vondeling",
            "rpdco": "Netherlands",
            "rpdatd": 1755290204,
            "rpdid": "NLZBW001",
            "rpdtt": "ATD",
            "rpda2": "nl",
            "rpdst": 1
          }
        }
      ]
    }
  },
  "headers": null
}
Available Fields
status_code, detail, arrival, total, pages, list, mmsi, name, imo, type, year, country, a2, gt, dw, sa, sizes, tlck, next, formattedETA, prev, rpzone, rpzone.name, rpzone.a2, rpzone.lat, rpzone.lon, rpzone.pk, rpdna, rpdco, rpdatd, rpdid, rpdtt, rpda2, rpdst, headers

Vessel Inspection Data

💳 3 credits
View Documentation
Endpoint
GET https://datadocked.com/api/vessels_operations/vessel_mou
Required Parameters
  • api_key:Your personal API key, found in your profile dashboard
  • imo:The IMO number of the vessel you want to query.
Example Request
https://datadocked.com/api/vessels_operations/vessel_mou?api_key=YOUR_API_KEY&imo=VESSEL_IMO_NUMBER

Response Format

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

Sample JSON Response
{
  "status_code": 200,
  "detail": {
    "specs": {
      "Flag": "Italy",
      "Call Sign": "IBEX",
      "MMSI": "247351100",
      "Gross tonnage": "40502 (since 01/03/2021)",
      "DWT": "7300",
      "Type of ship": "Passenger/Ro-Ro Ship (vehicles) (during 1999)",
      "Year of build": "1999",
      "Status": "In Service/Commission (since 07/05/1999)",
      "last_update": "Last update of ship particulars 26/08/2025"
    },
    "classification": {
      "status": {
        "society": "American Bureau of Shipping (IACS)",
        "status": "Reinstated",
        "since": "Survey overdue"
      },
      "surveys": [
        {
          "society": "Registro Italiano Navale (IACS)",
          "last_renewal": "25/04/2024",
          "next_renewal": "31/05/2029",
          "external_url": "https://www.leonardoinfo.com/leonardoInfo/LeoInfoLogInExternalServlet?ImoNum=9184419"
        }
      ]
    },
    "certificates": [
      {
        "classification_society": "Registro Italiano Navale (IACS)",
        "date_survey": "19/05/2025",
        "date_expiry": "",
        "date_change_status": "",
        "status": "",
        "reason": "",
        "top_cv": "Convention"
      },
      {
        "classification_society": "Registro Italiano Navale (IACS)",
        "date_survey": "02/03/2020",
        "date_expiry": "",
        "date_change_status": "",
        "status": "",
        "reason": "",
        "top_cv": "Convention"
      },
      {
        "classification_society": "Registro Italiano Navale (IACS)",
        "date_survey": "29/05/2015",
        "date_expiry": "",
        "date_change_status": "03/12/2014",
        "status": "Reassigned",
        "reason": "",
        "top_cv": "Convention"
      },
      {
        "classification_society": "Registro Italiano Navale (IACS)",
        "date_survey": "09/10/2009",
        "date_expiry": "",
        "date_change_status": "",
        "status": "",
        "reason": "",
        "top_cv": "Convention"
      },
      {
        "classification_society": "Registro Italiano Navale (IACS)",
        "date_survey": "14/10/2004",
        "date_expiry": "",
        "date_change_status": "",
        "status": "",
        "reason": "",
        "top_cv": "Convention"
      }
    ],
    "pi_info": [
      {
        "insurer": "Steamship Mutual Underwriting Association (Bermuda)",
        "inception": "21/08/2025"
      }
    ],
    "movements": [
      {"date_record": "August 2025", "area_seen": "Mediterranean Sea"},
      {"date_record": "July 2025", "area_seen": "Mediterranean Sea"},
      {"date_record": "June 2025", "area_seen": "Mediterranean Sea"},
      {"date_record": "May 2025", "area_seen": "Mediterranean Sea"},
      {"date_record": "April 2025", "area_seen": "Mediterranean Sea"},
      {"date_record": "March 2025", "area_seen": "Mediterranean Sea"},
      {"date_record": "February 2025", "area_seen": "Mediterranean Sea"},
      {"date_record": "January 2025", "area_seen": "Mediterranean Sea"},
      {"date_record": "December 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "November 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "October 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "September 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "August 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "July 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "June 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "May 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "April 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "March 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "February 2024", "area_seen": "Mediterranean Sea"},
      {"date_record": "January 2024", "area_seen": "Mediterranean Sea"}
    ],
    "list_view": {
      "imo": "1528772",
      "name": "Ship manager/Commercial manager",
      "ship_type": "Via Fieschi 17-17A, 16121, Genoa GE, Italy.",
      "year_built": "during 10/2014",
      "flag": ""
    },
    "inspection": [
      {
        "authority": "Spain",
        "port_of_inspection": "Barcelona",
        "date_of_report": "06/08/2025",
        "detention": "N",
        "psc_organisation": "Paris MoU",
        "type_of_inspection": "Expanded inspection",
        "duration_days": "",
        "number_of_deficiencies": "1",
        "inspection_id": "6286891",
        "detailed_info": {
          "port_state": {
            "PSC Organisation": "Paris MoU",
            "Authority": "Spain",
            "Port of inspection": "Barcelona",
            "Type of inspection": "Expanded inspection",
            "Date of report": "06/08/2025",
            "Detention": "No",
            "Number of deficiencies": "1"
          },
          "particulars": {
            "IMO number": "9184419",
            "Name of ship": "EXCELSIOR",
            "Call Sign": "IBEX",
            "Gross tonnage": "40502",
            "Type of ship": "RoRo passenger vessel",
            "Year of build": "1997"
          },
          "classification": {},
          "statutory": [
            {
              "certificate": "Maritime Labour Certificate",
              "ro_flag": "Italy",
              "issue_date": "2025-06-16",
              "expiry_date": "2030-05-21"
            },
            {
              "certificate": "Safety management certificat (SMC)",
              "ro_flag": "Italy",
              "issue_date": "2025-05-26",
              "expiry_date": "2030-05-28"
            },
            {
              "certificate": "Continuous Synopsis Record",
              "ro_flag": "Italy",
              "issue_date": "2025-05-15",
              "expiry_date": ""
            },
            {
              "certificate": "Passenger ship safety (inc. exemp.)",
              "ro_flag": "Italy",
              "issue_date": "2025-05-13",
              "expiry_date": "2026-05-30"
            },
            {
              "certificate": "International Ship Security Certificat",
              "ro_flag": "Registro Italiano Navale (IACS)",
              "issue_date": "2025-05-12",
              "expiry_date": "2030-05-26"
            },
            {
              "certificate": "Doc.of compliance dangerous goods",
              "ro_flag": "Registro Italiano Navale (IACS)",
              "issue_date": "2025-04-28",
              "expiry_date": "2026-05-31"
            },
            {
              "certificate": "International Oil pollution prevention (iopp)",
              "ro_flag": "Registro Italiano Navale (IACS)",
              "issue_date": "2024-08-20",
              "expiry_date": "2029-05-31"
            },
            {
              "certificate": "Load lines certificates",
              "ro_flag": "Registro Italiano Navale (IACS)",
              "issue_date": "2024-04-25",
              "expiry_date": "2029-05-31"
            },
            {
              "certificate": "International Air Pollution Prevention Cert",
              "ro_flag": "Registro Italiano Navale (IACS)",
              "issue_date": "2024-04-25",
              "expiry_date": "2029-05-31"
            },
            {
              "certificate": "International Sewage Pollution Prevention Certific",
              "ro_flag": "Registro Italiano Navale (IACS)",
              "issue_date": "2024-04-25",
              "expiry_date": "2029-05-31"
            },
            {
              "certificate": "Safety manning document",
              "ro_flag": "Italy",
              "issue_date": "2024-04-22",
              "expiry_date": ""
            },
            {
              "certificate": "International Energy Efficiency Certificate",
              "ro_flag": "Registro Italiano Navale (IACS)",
              "issue_date": "2023-06-28",
              "expiry_date": ""
            },
            {
              "certificate": "Document of compliance (DoC)",
              "ro_flag": "Italy",
              "issue_date": "2021-06-04",
              "expiry_date": "2026-05-24"
            },
            {
              "certificate": "Tonnage certificate",
              "ro_flag": "Italy",
              "issue_date": "2021-05-06",
              "expiry_date": ""
            },
            {
              "certificate": "International Anti-fouling System Certificate",
              "ro_flag": "Registro Italiano Navale (IACS)",
              "issue_date": "2021-05-03",
              "expiry_date": ""
            }
          ],
          "deficiencies": [
            {
              "category": "Safety of Navigation",
              "deficiency": "Voyage or passage plan",
              "defect": "",
              "total": "1"
            }
          ]
        }
      },
      {
        "authority": "Spain",
        "port_of_inspection": "Barcelona",
        "date_of_report": "16/07/2025",
        "detention": "N",
        "psc_organisation": "Paris MoU",
        "type_of_inspection": "Expanded inspection",
        "duration_days": "",
        "number_of_deficiencies": "2",
        "inspection_id": "6280883",
        "detailed_info": {
          "port_state": {
            "PSC Organisation": "Paris MoU",
            "Authority": "Spain",
            "Port of inspection": "Barcelona",
            "Type of inspection": "Expanded inspection",
            "Date of report": "16/07/2025",
            "Detention": "No",
            "Number of deficiencies": "2"
          },
          "particulars": {
            "IMO number": "9184419",
            "Name of ship": "EXCELSIOR",
            "Call Sign": "IBEX",
            "Gross tonnage": "40502",
            "Type of ship": "RoRo passenger vessel",
            "Year of build": "1997"
          },
          "deficiencies": [
            {
              "category": "Certificate and Documentation - Ship Certificates",
              "deficiency": "International sewage pollution prevention cert.",
              "defect": "",
              "total": "1"
            },
            {
              "category": "ISM",
              "deficiency": "ISM, related deficiencies",
              "defect": "",
              "total": "1"
            }
          ]
        }
      },
    ],
    "ship_history": {
      "current_and_former_names": [
        {
          "name": "EXCELSIOR",
          "date_of_effect": "since 01/01/1999",
          "source": "Lloyd's Register"
        }
      ],
      "current_and_former_flags": [
        {
          "flag": "Italy",
          "date_of_effect": "since 01/01/1999",
          "source": "Lloyd's Register"
        }
      ],
      "renewals": [
        {
          "classification_society": "Registro Italiano Navale (IACS)",
          "date_of_survey": "25/04/2024",
          "source": "Registro Italiano Navale"
        },
        {
          "classification_society": "Registro Italiano Navale (IACS)",
          "date_of_survey": "03/05/2021",
          "source": "Registro Italiano Navale"
        },
        {
          "classification_society": "Registro Italiano Navale (IACS)",
          "date_of_survey": "06/06/2019",
          "source": "Registro Italiano Navale"
        },
        {
          "classification_society": "Registro Italiano Navale (IACS)",
          "date_of_survey": "11/06/2014",
          "source": "Registro Italiano Navale"
        },
        {
          "classification_society": "Registro Italiano Navale (IACS)",
          "date_of_survey": "11/06/2009",
          "source": "Registro Italiano Navale"
        },
        {
          "classification_society": "Registro Italiano Navale (IACS)",
          "date_of_survey": "31/05/2004",
          "source": "Registro Italiano Navale"
        }
      ],
      "company_roles": [
        {
          "company": "GRANDI NAVI VELOCI SPA",
          "role": "Registered owner",
          "date_of_effect": "during 1999",
          "source": "Lloyd's Register"
        },
        {
          "company": "GRANDI NAVI VELOCI SPA",
          "role": "Ship manager/Commercial manager",
          "date_of_effect": "during 10/2014",
          "source": "Lloyd's Register"
        },
        {
          "company": "GRANDI NAVI VELOCI SPA",
          "role": "ISM manager",
          "date_of_effect": "during 1999",
          "source": "Lloyd's Register"
        }
      ]
    }
  }
}
Available Fields
status_code, detail, specs, specs.Flag, specs.Call Sign, specs.MMSI, specs.Gross tonnage, specs.DWT, specs.Type of ship, specs.Year of build, specs.Status, specs.last_update, classification, classification.status, classification.status.society, classification.status.status, classification.status.since, classification.surveys, classification.surveys.society, classification.surveys.last_renewal, classification.surveys.next_renewal, classification.surveys.external_url, certificates, pi_info, pi_info.insurer, pi_info.inception, movements, movements.date_record, movements.area_seen, movements.source, list_view, list_view.imo, list_view.name, list_view.ship_type, list_view.year_built, list_view.flag, inspection, ship_history, ship_history.current_and_former_names, ship_history.current_and_former_names.name, ship_history.current_and_former_names.date_of_effect, ship_history.current_and_former_names.source, ship_history.current_and_former_flags, ship_history.current_and_former_flags.flag, ship_history.current_and_former_flags.date_of_effect, ship_history.current_and_former_flags.source, ship_history.renewals, ship_history.renewals.classification_society, ship_history.renewals.date_of_survey, ship_history.renewals.source, ship_history.company_roles, ship_history.company_roles.company, ship_history.company_roles.role, ship_history.company_roles.date_of_effect, ship_history.company_roles.source, headers

Vessel Weather Data

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

Response Format

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

Sample JSON Response
{
  "status_code": 200,
  "detail": {
    "name": "BALTIC SPRING",
    "MMSI": "311001003",
    "IMO": "8909070",
    "temperature": "19 °C",
    "windSpeed": "2.4 m/s",
    "waves": "1.5 m."
  },
  "headers": null
}
Available Fields
status_code, detail, name, MMSI, IMO, temperature, windSpeed, waves, headers

API Playground

Test our API endpoints with real data. Try different parameters and see live responses.

Select API Endpoint

Request

GET

Get comprehensive vessel information

PARAMETERS

Your personal API key

IMO or MMSI number of the vessel

Response

Click "TRY IT OUT" to see the response

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}")