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.
Download API Specs
OpenAPI Spec
Download OpenAPI 3.1 JSON schema
Postman Collection
Import directly into Postman
Base URL
Authentication
All requests require an API key in thex-api-key header.
Get your API key
Sign up for free to 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
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 thedetail field:
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 |
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 theimo_or_mmsi parameter.
Data Sources
| Source | Coverage | Endpoints |
|---|---|---|
| Terrestrial AIS | Coastal waters | All endpoints |
| Satellite AIS | Global | Real-time location, Historical data |
dataSource field in responses indicates whether data came from terrestrial or satellite receivers.