Use the UN/LOCODE dataset with ease in your applications


Use the UN/LOCODE dataset with ease in your applications

SKU: P8-UN-LOCODE Category: Tag:
Powered by




An API built on top of the UN/LOCODE dataset is made available allowing you to integrate it into your own systems or applications. When the dataset is renewed, Platform8 will update the data. So the next time you call the API, you automatically get the right information.
Since there was a need for an international and efficient convention to represent locations, the UN has put in place a code system. This code system is referred to as the United Nations LOCODE (UN/LOCODE) and is intended to cover ports, airports, and other locations which are frequently used for goods movement associated with international trade.

The UN/LOCODE API allows you to:

  • Get location details based on a location code
  • Search for locations based on simple search parameters
  • Search for locations near a point on a map
  • Etc

The list of codes is based on entries from governments and international organisations, or requests received from users. UN/LOCODE will continuously be maintained and are made available in the form of datasets on the UN website (that can be consulted or downloaded). Twice per year the list is updated and re-published.

Unfortunately, the lack of API’s may prevent companies and organizations from using the UN standardised codes and opt for their own internal location codes instead. Platform8 is offering the UN/LOCODE data in a more user-friendly format and makes it accessible via API’s so that applications can easily consult it.

Data Provider

Platform8 keeps the API up-to-date with the latest UN dataset (available here). Any requests for locations to be added to the API can be discussed with Platform8.


This API is a direct access API.

This means that the data is not under specific sharing control and that there is no need to implement a full authentication flow. The only thing you need is an API key to add to the header of your API call. You can get that key by subscribing to the API. API usage is metered and billed based on this API key. If usage should be billed to the users of your application, you should ask those users to bring their own key.