Skip to main content

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

Sign up for free to get your API key

Endpoints Overview


Quick Examples

# 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"

Credit Costs

EndpointCredits
My Credits0
Get Vessel Location1
Get Vessel Particulars1
Get Vessel Engine Data1
Get Vessel Management Data1
Vessel Details by Name1
Vessel Weather Data1
Port Calls by Vessel1
Vessel Inspection Data3
Get Vessel Info5
Get Vessels by Area10
Port Calls by Port50
Bulk Location Search1 per vessel
Historical Data5 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

CodeDescription
200Success
400Bad request - Invalid parameters
401Unauthorized - Invalid or missing API key
404Not found - Vessel or resource not found
429Too many requests - Rate limit exceeded
500Server 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

SourceCoverageEndpoints
Terrestrial AISCoastal watersAll endpoints
Satellite AISGlobalReal-time location, Historical data
The dataSource field in responses indicates whether data came from terrestrial or satellite receivers.