Documentation Index
Fetch the complete documentation index at: https://docs.datadocked.com/llms.txt
Use this file to discover all available pages before exploring further.
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"
{
"detail": "99929 credits left."
}
Common Endpoints
Vessel Location
1 credit - Real-time position
Full Vessel Info
5 credits - Complete vessel profile
Port Calls
1 credit - Port history
Bulk Search
1 credit/vessel - Up to 50 vessels
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"
}
]
}
Download API Specs
OpenAPI Spec
OpenAPI 3.1 JSON schema
Postman Collection
Import directly into Postman
Next Steps
API Reference
Explore all 14 endpoints
SDKs
Integration examples in multiple languages
Use Cases
See how companies use the API
Credits
Understand pricing
