Case Status
Log In


Get and Test your API key
  • RSS Feed

Last modified on 4/5/2017 3:08 PM by User.

Get and Test your API key

There are 3 steps required to get an API key

  1. Sign up to
  2. Email us to request your account be upgraded to include access to the API
  3. Once we have upgraded your account, you can apply for an API Key

The API Key

The API Key is a string of 30 characters, and looks like "de42a32a48b80678837ba605b258f2"

It is used in the querystring in each API call and is a mandatory parameter:

Test your API key

Click this link to try to return some summary information about the port of Aabenraa in Denmark. It should try to open this link:


At first, the link will return no information. You need to add your API key to the end of the URL in the address bar to correctly form the API request. For example, if your API key is "0123456789abcdefg" then the address for the API call would be:


You should see output like this in your browser:



The API key gives access to the API for anyone using it. You should take steps to ensure that the key cannot be read in plain text in javascript, php or other code files.

Error codes

A failure to authenticate, usually because the key string is incorrect, will raise an error.

Other errors, all of which your code should detect and manage, are documented in Error Codes.


==> Next: Download sample applications


If you would like to find out more about or our Findaport API service, please contact us at Shipping Guides Ltd are recognised industry specialists in publishing port and harbour information for your various port entry requirements. For more information on our products, please visit