Uljas API

Businesses and individuals now have access to customs statistics on foreign trade via an open data interface. Statistical data and associated metadata from Finnish Customs Uljas statistical database can be downloaded via an application programming interface called API (Application Programming Interface). API queries can, for example, be used to build applications for smart phones or new web services. The available formats are CSV, JSON, JSON-STAT or XML. HTTP GET or POST queries are used for data requests. The query is defined by various parameters.

Four different types of queries are available via the statistical database interface. The first three are queries for the metadata and fourth for the statistical data:


Returns the names of the statistics files present in the database.
Example: http://uljas.tulli.fi/graph/api.aspx?lang=en&atype=stats&konv=json


Returns the dimensions that are available for a certain statistics file specified with ifile parameter.
Example: http://uljas.tulli.fi/graph/api.aspx?lang=en&atype=dims&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC


Returns the values that are in the classification (specified with class parameter) for a certain statistics file (specified with ifile parameter).
Example: http://uljas.tulli.fi/graph/api.aspx?lang=en&atype=class&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC


Returns the data values that are returned with certain class value combinations from a certain statistics file (specified with ifile parameter). 
Example: http://uljas.tulli.fi/graph/api.aspx?lang=en&atype=data&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC&Classification%20of%20Products%20SITC1=0-9&Country=DE&Timeperiod==FIRST*;12&Flow=2&Indicators=V1

An individual request return is limited to 50 000 cells.

Please read the API manual thoroughly before using the service.

Finnish Customs provides the API as is and does not take responsibility for any system downtime, technical failures, or for any products/services that are based on the API.

Contact us
Statistics service
weekdays from 9 am to 2.30 pm