FAQ
Frequently Asked Questions
Below you will find answers to some of the most common questions regarding our API. We cover topics from data coverage to account management. If you need more details, please consult the full documentation or contact support.
General & Data Coverage
How long does it take for a new position to be available in the API?
We use cutting-edge technology to ensure real-time performance. For vessels within coverage, new positions are available in the API in under 1 second from the moment our main servers receives the raw AIVDM message.
Why are some vessels out of coverage?
Our API is powered exclusively by terrestrial AIS data. This means that vessel coverage depends on the availability of terrestrial antennas. In areas with limited infrastructure, some vessels may not be detected, which is why they can appear out of coverage.
What are the API rate limits?
Valid API key users can make up to 2000 calls per minute, while trial users are limited to 90 calls per minute.
What happens if I exceed my API rate limits?
If you exceed your rate limits, you will be temporarily banned—1 minute for valid API key users and 5 minutes for IP-based calls. Overuse protection ensures that you are never charged more than your available coin balance.
Account & API Key Management
How do I obtain an API key?
To obtain an API key, register for a free account at MyShipTracking.com. Once registered, log in to your account and generate your unique API Key and Secret. Each account is limited to one API key, which comes with a coin limit of 2000 and is active for a maximum of 10 days.
Can I regenerate my API key?
Yes, you can regenerate your API key and Secret at any time from your account page on MyShipTracking.com. Regenerating a key will invalidate your previous credentials.
What is the maximum active period for my trial API key?
Trial API keys are active for a maximum of 10 days.
Are unused credits carried over to the next month?
No, credits are not transferable. Each month, your credit balance resets to the predefined amount. For example, if your monthly allocation is 10,000 credits, any unused credits from the previous month do not carry over.