Get Your API Key
Track a Vessel
Get the real-time location of any vessel using its IMO or MMSI number.
cURL
Python
JavaScript
Go
curl -X GET "https://datadocked.com/api/vessels_operations/get-vessel-location?imo_or_mmsi=9247431" \
-H "x-api-key: YOUR_API_KEY"
import requests
response = requests.get(
"https://datadocked.com/api/vessels_operations/get-vessel-location",
params={"imo_or_mmsi": "9247431"},
headers={"x-api-key": "YOUR_API_KEY"}
)
vessel = response.json()["detail"]
print(f"Vessel: {vessel['name']}")
print(f"Position: {vessel['latitude']}, {vessel['longitude']}")
print(f"Speed: {vessel['speed']} knots")
print(f"Destination: {vessel['destination']}")
const response = await fetch(
"https://datadocked.com/api/vessels_operations/get-vessel-location?imo_or_mmsi=9247431",
{ headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { detail: vessel } = await response.json();
console.log(`Vessel: ${vessel.name}`);
console.log(`Position: ${vessel.latitude}, ${vessel.longitude}`);
console.log(`Speed: ${vessel.speed} knots`);
req, _ := http.NewRequest("GET",
"https://datadocked.com/api/vessels_operations/get-vessel-location?imo_or_mmsi=9247431",
nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
Response
{
"detail": {
"name": "REGAL_I",
"imo": "9247431",
"mmsi": "655919000",
"latitude": "33.384193",
"longitude": "128.03142",
"speed": "1.1",
"course": "91",
"heading": "89",
"destination": "Suez canal Egypt",
"navigationalStatus": "Underway using Engine",
"positionReceived": "Jan 04, 2026 04:15 UTC",
"dataSource": "Satellite"
}
}
Check Your Credits
curl "https://datadocked.com/api/vessels_operations/my-credits" \
-H "x-api-key: YOUR_API_KEY"
Response:
{
"detail": "99929 credits left."
}
Common Endpoints
Finding Vessel Identifiers
Search by Name
curl "https://datadocked.com/api/vessels_operations/vessels-by-vessel-name?name=EVER_GIVEN" \
-H "x-api-key: YOUR_API_KEY"
Replace spaces in vessel names with underscores: EVER GIVEN → EVER_GIVEN
Response
{
"total": 1,
"items": [
{
"name": "EVER GIVEN",
"imo": "9811000",
"mmsi": "353136000",
"country": "Panama",
"type": "Container Ship"
}
]
}
Next Steps