Statistics Finland

Statistics Finland Classifications API

The Classifications API from Statistics Finland — 4 operation(s) for classifications.

GitHub OpenAPI

Operations 4

GET /api/classifications/v2/classifications List classifications. Returns all classifications #
GET /api/classifications/v2/classifications/{classification} Returns a classification #
GET /api/classifications/v2/classifications/{classification}/classificationItems List classification items. Returns classification items #
GET /api/classifications/v2/classifications/{classification}/classificationItems/{classificationItem} Returns a classification item #

Documentation

📖
Documentation
https://api.stat.fi/docs/
📖
Documentation
https://stat.fi/media/uploads/org_en/avoindata/oapif_rajapinta_selaimessa_ohje_en.pdf

Specifications

⚙
OpenAPI
https://artifacts.apis.io/stat-fi/openapi/stat-fi-classifications-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/stat-fi/json-schema/stat-fi-classification-min-schema.json
📊
JSONSchema
https://artifacts.apis.io/stat-fi/json-schema/stat-fi-classification-item-with-classification-min-min-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/stat-fi:stat-fi-classifications-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

stat-fi-classifications-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Stat Fi Classifications API
  version: '1.0'
  contact:
    name: Developers
    email: jakelupalvelut@stat.fi
  license:
    name: CC BY 4.0
    url: https://stat.fi/org/lainsaadanto/copyright_en.html
  description: 'Operations tagged Classifications across 2 of this provider''s published API definitions: stat-fi-classifications-openapi.yaml, stat-fi-classifications-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.stat.fi/classificationservice/open
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Classifications
paths:
  /api/classifications/v2/classifications:
    get:
      tags:
      - Classifications
      summary: List classifications. Returns all classifications
      operationId: get-api-classifications-v2-classifications
      parameters:
      - name: content
        in: query
        description: Wanted return type, `data` or `url`, by default returns list of urls
        schema:
          $ref: '#/components/schemas/ReturnType'
      - name: meta
        in: query
        description: Wanted meta data amount. `min` or `max`, by default returns maximum amount of meta data
        schema:
          $ref: '#/components/schemas/MetaLimits'
      - name: lang
        in: query
        description: Wanted language for data. `fi`, `sv` or `en`, by default returns fi
        schema:
          $ref: '#/components/schemas/Language'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationMin'
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationMin'
              example:
              - classificationSerie:
                  localId: string
                  classificationSerieName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationSerieDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                localId: kunta_1_20180101
                internationalRecommendation: true
                nationalRecommendation: true
                classificationName:
                - langName: suomi
                  lang: fi
                  name: string
                classificationDescription:
                - langName: suomi
                  lang: fi
                  description: string
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationMin'
              example:
              - classificationSerie:
                  localId: string
                  classificationSerieName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationSerieDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                localId: kunta_1_20180101
                internationalRecommendation: true
                nationalRecommendation: true
                classificationName:
                - langName: suomi
                  lang: fi
                  name: string
                classificationDescription:
                - langName: suomi
                  lang: fi
                  description: string
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                type: string
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: string
              example: string
            text/json:
              schema:
                type: string
              example: string
    servers:
    - url: https://api.stat.fi/classificationservice/open
  /api/classifications/v2/classifications/{classification}:
    get:
      tags:
      - Classifications
      summary: Returns a classification
      operationId: get-api-classifications-v2-classifications-classification
      parameters:
      - name: classification
        in: path
        description: localId (e.g. `kunta_1_20180101`)
        required: true
        schema:
          type: string
          default: ''
      - name: content
        in: query
        description: Wanted return type, `data` or `url`, by default returns list of urls
        schema:
          $ref: '#/components/schemas/ReturnType'
      - name: meta
        in: query
        description: Wanted meta data amount. `min` or `max`, by default returns maximum amount of meta data
        schema:
          $ref: '#/components/schemas/MetaLimits'
      - name: lang
        in: query
        description: Wanted language for data. `fi`, `sv` or `en`, by default returns fi
        schema:
          $ref: '#/components/schemas/Language'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationMin'
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationMin'
              example:
              - classificationSerie:
                  localId: string
                  classificationSerieName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationSerieDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                localId: kunta_1_20180101
                internationalRecommendation: true
                nationalRecommendation: true
                classificationName:
                - langName: suomi
                  lang: fi
                  name: string
                classificationDescription:
                - langName: suomi
                  lang: fi
                  description: string
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationMin'
              example:
              - classificationSerie:
                  localId: string
                  classificationSerieName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationSerieDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                localId: kunta_1_20180101
                internationalRecommendation: true
                nationalRecommendation: true
                classificationName:
                - langName: suomi
                  lang: fi
                  name: string
                classificationDescription:
                - langName: suomi
                  lang: fi
                  description: string
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                type: string
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: string
              example: string
            text/json:
              schema:
                type: string
              example: string
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                type: string
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: string
              example: string
            text/json:
              schema:
                type: string
              example: string
    servers:
    - url: https://api.stat.fi/classificationservice/open
  /api/classifications/v2/classifications/{classification}/classificationItems:
    get:
      tags:
      - Classifications
      summary: List classification items. Returns classification items
      description: List classification items. Returns classification items.
      operationId: get-api-classifications-v2-classifications-classification-classificationitem
      parameters:
      - name: classification
        in: path
        description: localId (e.g. `kunta_1_20180101`)
        required: true
        schema:
          type: string
          default: ''
      - name: content
        in: query
        description: Wanted return type, `data` or `url`, by default returns list of urls
        schema:
          $ref: '#/components/schemas/ReturnType'
      - name: meta
        in: query
        description: Wanted meta data amount. `minmin`, `min` or `max`, by default returns maximum amount of meta data
        schema:
          $ref: '#/components/schemas/MetaLimitsWithMinMin'
      - name: lang
        in: query
        description: Wanted language for data. `fi`, `sv` or `en`, by default returns fi
        schema:
          $ref: '#/components/schemas/Language'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationItemWithClassificationMinMin'
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationItemWithClassificationMinMin'
              example:
              - level: 0
                code: string
                order: 0
                parentCode: string
                name: string
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationItemWithClassificationMinMin'
              example:
              - level: 0
                code: string
                order: 0
                parentCode: string
                name: string
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                type: string
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: string
              example: string
            text/json:
              schema:
                type: string
              example: string
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                type: string
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: string
              example: string
            text/json:
              schema:
                type: string
              example: string
    servers:
    - url: https://api.stat.fi/classificationservice/open
  /api/classifications/v2/classifications/{classification}/classificationItems/{classificationItem}:
    get:
      tags:
      - Classifications
      summary: Returns a classification item
      operationId: get-api-classifications-v2-classifications-classification-classificationitem-1
      parameters:
      - name: classification
        in: path
        description: localId (e.g. `kunta_1_20180101`)
        required: true
        schema:
          type: string
          default: ''
      - name: classificationItem
        in: path
        description: code (e.g. `178`)
        required: true
        schema:
          type: string
          default: ''
      - name: content
        in: query
        description: Wanted return type, `data` or `url`, by default returns list of urls
        schema:
          $ref: '#/components/schemas/ReturnType'
      - name: meta
        in: query
        description: Wanted meta data amount. `minmin`, `min` or `max`, by default returns maximum amount of meta data
        schema:
          $ref: '#/components/schemas/MetaLimitsWithMinMin'
      - name: lang
        in: query
        description: Wanted language for data. `fi`, `sv` or `en`, by default returns fi
        schema:
          $ref: '#/components/schemas/Language'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationItemWithClassificationMinMin'
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationItemWithClassificationMinMin'
              example:
              - level: 0
                code: string
                order: 0
                parentCode: string
                name: string
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationItemWithClassificationMinMin'
              example:
              - level: 0
                code: string
                order: 0
                parentCode: string
                name: string
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                type: string
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: string
              example: string
            text/json:
              schema:
                type: string
              example: string
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                type: string
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: string
              example: string
            text/json:
              schema:
                type: string
              example: string
    servers:
    - url: https://api.stat.fi/classificationservice/open
components:
  schemas:
    ClassificationSerieName:
      type: object
      properties:
        langName:
          maxLength: 30
          type:
          - string
          - 'null'
          description: Language name
          example: suomi
        lang:
          maxLength: 3
          type:
          - string
          - 'null'
          description: Language code
          example: fi
        name:
          maxLength: 100
          type:
          - string
          - 'null'
          description: Name
      additionalProperties: false
      description: ClassificationSerieName
    ClassificationDescription:
      type: object
      properties:
        langName:
          maxLength: 30
          type:
          - string
          - 'null'
          description: Language name
          example: suomi
        lang:
          maxLength: 3
          type:
          - string
          - 'null'
          description: Language code
          example: fi
        description:
          maxLength: 300
          type:
          - string
          - 'null'
          description: Classification description
      additionalProperties: false
      description: ClassificationDescription
    ReturnType:
      enum:
      - url
      - data
      type: string
      description: What kind of content should be returned
    MetaLimits:
      enum:
      - max
      - min
      type: string
      description: Wanted meta data amount
    ClassificationItemWithClassificationMinMin:
      type: object
      properties:
        level:
          type: number
          description: Level
          format: double
        code:
          maxLength: 50
          type:
          - string
          - 'null'
          description: Code of classification item
        order:
          type:
          - integer
          - 'null'
          description: Order number
          format: int32
        parentCode:
          maxLength: 50
          type:
          - string
          - 'null'
          description: Code of classification item parent
        name:
          type:
          - string
          - 'null'
          description: Classification item name
      additionalProperties: false
      description: ClassificationItem with Classification with minmin filtering
    Language:
      enum:
      - fi
      - sv
      - en
      type: string
      description: Wanted language for data
    ClassificationSerieDescription:
      type: object
      properties:
        langName:
          maxLength: 30
          type:
          - string
          - 'null'
          description: Language name
          example: suomi
        lang:
          maxLength: 3
          type:
          - string
          - 'null'
          description: Language code
          example: fi
        description:
          maxLength: 300
          type:
          - string
          - 'null'
          description: Description of classification serie
      additionalProperties: false
      description: ClassificationSerieDescription contains description of classification serie
    ClassificationSerie:
      type: object
      properties:
        localId:
          maxLength: 100
          type:
          - string
          - 'null'
          description: Classfication serie local Id
        classificationSerieName:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ClassificationSerieName'
          description: Classification serie name
        classificationSerieDescription:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ClassificationSerieDescription'
          description: Classification serie description
      additionalProperties: false
      description: ClassificationSerie contains small info about classification serie
    MetaLimitsWithMinMin:
      enum:
      - max
      - min
      - minmin
      type: string
      description: Wanted meta data amount
    ClassificationMin:
      type: object
      properties:
        classificationSerie:
          $ref: '#/components/schemas/ClassificationSerie'
        localId:
          maxLength: 100
          type:
          - string
          - 'null'
          description: Classification Local Id
          example: kunta_1_20180101
        internationalRecommendation:
          type: boolean
          description: Is international recommendation
        nationalRecommendation:
          type: boolean
          description: Is national recommendation
        classificationName:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ClassificationName'
          description: Classification name
        classificationDescription:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ClassificationDescription'
          description: Classification description
      additionalProperties: false
      description: ClassificationMin contains meta level min info of a single classification
    ClassificationName:
      type: object
      properties:
        langName:
          maxLength: 30
          type:
          - string
          - 'null'
          description: Language name
          example: suomi
        lang:
          maxLength: 3
          type:
          - string
          - 'null'
          description: Language code
          example: fi
        name:
          maxLength: 300
          type:
          - string
          - 'null'
          description: Name
      additionalProperties: false
      description: ClassificationName
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      name: Ocp-Apim-Subscription-Key
      in: header
    apiKeyQuery:
      type: apiKey
      name: subscription-key
      in: query
x-refined-from:
- stat-fi-classifications-openapi.yaml
- stat-fi-classifications-openapi.yml