Changes will be made to the Uljas statistical database on 30.3.2026 that affect Uljas API queries. Queries must be created again to the new statistical cubes CN, SITC, CPA, TOL and BEC. Time series in the new cubes begins from January 2026 for imports and from January 2025 for exports. Data prior to 2026 can be found in other cubes that are updated until final data for the year 2025 is published on 28.8.2026.
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.
