Uljas API

Businesses and individuals have access to customs statistics on international 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 (API). 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.

The Creative Commons Attribution 4.0 International licence is applied to Finnish Customs statistical data published in the Uljas database. This is a licence according to the JHS 189 recommendation for open data files in public administration. 

Statistical data can be used freely in every possible way provided that the source is mentioned. The user accepts these Terms of Use by receiving, downloading or otherwise making use of the material.

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:

*Stats

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

*Dims

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

*Class

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

*Data

Returns the data values that are returned with certain class value combinations from a certain statistics file (specified with ifile parameter). 
Example: https://uljas.tulli.fi/uljas/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&Period==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.

Any questions?

Statistics service
Mon–Fri 9 am–2.30 pm
vs99Tglox1jZvyyhgNuiYv7CJT6fpvgfvgngf

You can ask about

  • finding and interpreting statistics on the foreign trade of goods
  • the use of the service for searching data in international trade statistics i.e. ULJAS database. 

Keywords Uljas database