About the data and API
Where VesselTrack's vessel data comes from, how often it refreshes, and how to read it from your own code.
Where the data comes from
VesselTrack receives Automatic Identification System (AIS) reports through AISStream and stores them in its own database. The map and API read those stored reports.
- AISStream vessel data
Live Class A and Class B AIS reports provide vessel positions, speed, course, heading and navigation status. Static and voyage reports provide vessel names, MMSI and IMO identifiers, call signs, types, dimensions and draught when transmitted.
- Mapbox maps
The background map, coastlines and place labels. Vessel positions and tracks are drawn from the AIS reports stored by VesselTrack.
How often the data refreshes
A page refresh does not necessarily mean a new AIS report has arrived. Check the vessel's observation time to see when its position was reported.
- AIS reportsContinuous stream
- VesselTrack stores accepted AIS reports as they arrive from AISStream. Coverage depends on the configured receiving area and available transmissions.
- Live mapEvery 30 seconds
- The map reads the latest stored positions in the current view and reloads when you move the map. Up to 20,000 vessels are shown; zoom in to see a smaller area.
- Vessel details and tracksEvery 30 seconds
- The selected vessel's profile and recent reports refresh together. Load older track or all saved history with no total position limit. The summary shows every loaded report; the map simplifies long tracks as you zoom out.
Coverage and limitations
AIS coverage is incomplete, especially offshore. Vessels may stop transmitting or move outside receiver coverage, leaving gaps in their tracks. The latest stored position may be old.
Vessel details are reported by the vessel and can be missing, outdated or incorrect. Unavailable readings are left blank; VesselTrack does not currently derive a vessel's flag from its MMSI. Use AIS as supporting information, not as a navigation aid or proof of a vessel's identity or location.
API
Vessel search, latest positions, profiles and stored tracks are available as JSON at https://api.vesseltrack.gighc.com. Create a consumer key on the API keys page and send it with each request as a Bearer token or an X-API-Key header.
Read the API reference for endpoints, filters and response formats.