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.