API Reference - Data Docked

Download API Specs

OpenAPI Spec

Download OpenAPI 3.1 JSON schema

Postman Collection

Import directly into Postman

Base URL

https://datadocked.com/api/vessels_operations

Authentication

All requests require an API key in the x-api-key header.

curl -X GET "https://datadocked.com/api/vessels_operations/get-vessel-location?imo_or_mmsi=9247431" \
  -H "x-api-key: YOUR_API_KEY"

Get your API key

Endpoints Overview

Account

Check credit balance

Vessel Tracking

Real-time vessel positions

Vessel Details

Specifications and management

Port Operations

Port calls and traffic

Quick Examples

cURL
Python
JavaScript

# Get vessel location
curl "https://datadocked.com/api/vessels_operations/get-vessel-location?imo_or_mmsi=9247431" \
  -H "x-api-key: YOUR_API_KEY"

# Check credits
curl "https://datadocked.com/api/vessels_operations/my-credits" \
  -H "x-api-key: YOUR_API_KEY"

import requests

headers = {"x-api-key": "YOUR_API_KEY"}
base = "https://datadocked.com/api/vessels_operations"

# Get vessel location
resp = requests.get(f"{base}/get-vessel-location",
                   params={"imo_or_mmsi": "9247431"},
                   headers=headers)
vessel = resp.json()["detail"]
print(f"{vessel['name']}: {vessel['latitude']}, {vessel['longitude']}")

const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://datadocked.com/api/vessels_operations';

// Get vessel location
const resp = await fetch(`${BASE}/get-vessel-location?imo_or_mmsi=9247431`, {
  headers: { 'x-api-key': API_KEY }
});
const { detail } = await resp.json();
console.log(`${detail.name}: ${detail.latitude}, ${detail.longitude}`);

Credit Costs

Endpoint	Credits
My Credits	0
Get Vessel Location	1
Get Vessel Particulars	1
Get Vessel Engine Data	1
Get Vessel Management Data	1
Vessel Details by Name	1
Vessel Weather Data	1
Port Calls by Vessel	1
Vessel Inspection Data	3
Get Vessel Info	5
Get Vessels by Area	10
Port Calls by Port	50
Bulk Location Search	1 per vessel
Historical Data	5 per date

Response Format

All responses return JSON with data in the detail field:

{
  "detail": {
    "name": "EVER GIVEN",
    "imo": "9811000",
    "mmsi": "353136000",
    "latitude": "31.234567",
    "longitude": "32.345678",
    "speed": "12.5",
    "course": "180",
    "destination": "ROTTERDAM"
  }
}

Error Codes

Code	Description
200	Success
400	Bad request - Invalid parameters
401	Unauthorized - Invalid or missing API key
404	Not found - Vessel or resource not found
429	Too many requests - Rate limit exceeded
500	Server error

Error response format:

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key"
}

Identifiers

IMO Number

A 7-digit unique identifier assigned to ships by the International Maritime Organization.

MMSI

A 9-digit Maritime Mobile Service Identity used for radio communication. Most endpoints accept either IMO or MMSI in the imo_or_mmsi parameter.

Data Sources

Source	Coverage	Endpoints
Terrestrial AIS	Coastal waters	All endpoints
Satellite AIS	Global	Real-time location, Historical data

The dataSource field in responses indicates whether data came from terrestrial or satellite receivers.

​Download API Specs

OpenAPI Spec

Postman Collection

​Base URL

​Authentication

Get your API key

​Endpoints Overview

Account

Vessel Tracking

Vessel Details

Port Operations

​Quick Examples

​Credit Costs

​Response Format

​Error Codes

​Identifiers

​IMO Number

​MMSI

​Data Sources