Statistics Finland Correspondence Tables API

The CorrespondenceTables API from Statistics Finland — 4 operation(s) for correspondencetables.

Documentation GitHub OpenAPI

Operations 4

GET /api/classifications/v2/correspondenceTables List correspondencetables. Returns all correspondencetables #

GET /api/classifications/v2/correspondenceTables/{correspondenceTable} Returns a correspondencetable #

GET /api/classifications/v2/correspondenceTables/{correspondenceTable}/maps List correspondencetablemaps. Returns all correspondencetablemaps #

GET /api/classifications/v2/correspondenceTables/{correspondenceTable}/maps/{sourceCode}/{targetCode} Returns a correspondencetablemap #

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-correspondencetables-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

openapi: 3.2.0
info:
  title: Stat Fi Correspondence Tables 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 CorrespondenceTables 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: CorrespondenceTables
paths:
  /api/classifications/v2/correspondenceTables:
    get:
      tags:
      - CorrespondenceTables
      summary: List correspondencetables. Returns all correspondencetables
      description: List correspondencetables. Returns all correspondencetables.
      operationId: get-api-classifications-v2-correspondencetables
      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/CorrespondenceTable'
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CorrespondenceTable'
              example:
              - source:
                  classificationSerie:
                    localId: string
                    classificationSerieName:
                    - langName: suomi
                      lang: fi
                      name: string
                    classificationSerieDescription:
                    - langName: suomi
                      lang: fi
                      description: string
                  localId: string
                  internationalRecommendation: true
                  nationalRecommendation: true
                  classificationName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                target:
                  classificationSerie:
                    localId: string
                    classificationSerieName:
                    - langName: suomi
                      lang: fi
                      name: string
                    classificationSerieDescription:
                    - langName: suomi
                      lang: fi
                      description: string
                  localId: string
                  internationalRecommendation: true
                  nationalRecommendation: true
                  classificationName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                localId: string
                sourceClassification: string
                targetClassification: string
                modifiedDate: string
                correspondenceTableTexts:
                - langName: suomi
                  lang: fi
                  description: string
                  updates: string
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CorrespondenceTable'
              example:
              - source:
                  classificationSerie:
                    localId: string
                    classificationSerieName:
                    - langName: suomi
                      lang: fi
                      name: string
                    classificationSerieDescription:
                    - langName: suomi
                      lang: fi
                      description: string
                  localId: string
                  internationalRecommendation: true
                  nationalRecommendation: true
                  classificationName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                target:
                  classificationSerie:
                    localId: string
                    classificationSerieName:
                    - langName: suomi
                      lang: fi
                      name: string
                    classificationSerieDescription:
                    - langName: suomi
                      lang: fi
                      description: string
                  localId: string
                  internationalRecommendation: true
                  nationalRecommendation: true
                  classificationName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                localId: string
                sourceClassification: string
                targetClassification: string
                modifiedDate: string
                correspondenceTableTexts:
                - langName: suomi
                  lang: fi
                  description: string
                  updates: string
    servers:
    - url: https://api.stat.fi/classificationservice/open
  /api/classifications/v2/correspondenceTables/{correspondenceTable}:
    get:
      tags:
      - CorrespondenceTables
      summary: Returns a correspondencetable
      operationId: get-api-classifications-v2-correspondencetables-correspondencetable
      parameters:
      - name: correspondenceTable
        in: path
        description: localId (e.g. `kunta_1_20180101#maakunta_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:
                $ref: '#/components/schemas/CorrespondenceTableMin'
              examples:
                default:
                  value: null
            application/json:
              schema:
                $ref: '#/components/schemas/CorrespondenceTableMin'
              example:
                source:
                  classificationSerie:
                    localId: string
                    classificationSerieName:
                    - langName: suomi
                      lang: fi
                      name: string
                    classificationSerieDescription:
                    - langName: suomi
                      lang: fi
                      description: string
                  localId: string
                  internationalRecommendation: true
                  nationalRecommendation: true
                  classificationName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                target:
                  classificationSerie:
                    localId: string
                    classificationSerieName:
                    - langName: suomi
                      lang: fi
                      name: string
                    classificationSerieDescription:
                    - langName: suomi
                      lang: fi
                      description: string
                  localId: string
                  internationalRecommendation: true
                  nationalRecommendation: true
                  classificationName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                localId: string
                sourceClassification: string
                targetClassification: string
                correspondenceTableTexts:
                - langName: suomi
                  lang: fi
                  description: string
                  updates: string
            text/json:
              schema:
                $ref: '#/components/schemas/CorrespondenceTableMin'
              example:
                source:
                  classificationSerie:
                    localId: string
                    classificationSerieName:
                    - langName: suomi
                      lang: fi
                      name: string
                    classificationSerieDescription:
                    - langName: suomi
                      lang: fi
                      description: string
                  localId: string
                  internationalRecommendation: true
                  nationalRecommendation: true
                  classificationName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                target:
                  classificationSerie:
                    localId: string
                    classificationSerieName:
                    - langName: suomi
                      lang: fi
                      name: string
                    classificationSerieDescription:
                    - langName: suomi
                      lang: fi
                      description: string
                  localId: string
                  internationalRecommendation: true
                  nationalRecommendation: true
                  classificationName:
                  - langName: suomi
                    lang: fi
                    name: string
                  classificationDescription:
                  - langName: suomi
                    lang: fi
                    description: string
                localId: string
                sourceClassification: string
                targetClassification: string
                correspondenceTableTexts:
                - langName: suomi
                  lang: fi
                  description: string
                  updates: string
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              examples:
                default:
                  value: null
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: string
                title: string
                status: 0
                detail: string
                instance: string
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: string
                title: string
                status: 0
                detail: string
                instance: string
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              examples:
                default:
                  value: null
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: string
                title: string
                status: 0
                detail: string
                instance: string
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: string
                title: string
                status: 0
                detail: string
                instance: string
    servers:
    - url: https://api.stat.fi/classificationservice/open
  /api/classifications/v2/correspondenceTables/{correspondenceTable}/maps:
    get:
      tags:
      - CorrespondenceTables
      summary: List correspondencetablemaps. Returns all correspondencetablemaps
      description: List correspondencetablemaps. Returns all correspondencetablemaps.
      operationId: get-api-classifications-v2-correspondencetables-correspondencetable-maps
      parameters:
      - name: correspondenceTable
        in: path
        description: localId (e.g. `kunta_1_20180101#maakunta_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/MapMinMin'
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MapMinMin'
              example:
              - distributionSourceToTarget: 0
                distributionTargetToSource: 0
                sourceClassification: string
                targetClassification: string
                sourceItem:
                  level: 0
                  code: string
                  order: 0
                  parentCode: string
                  name: string
                targetItem:
                  level: 0
                  code: string
                  order: 0
                  parentCode: string
                  name: string
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MapMinMin'
              example:
              - distributionSourceToTarget: 0
                distributionTargetToSource: 0
                sourceClassification: string
                targetClassification: string
                sourceItem:
                  level: 0
                  code: string
                  order: 0
                  parentCode: string
                  name: string
                targetItem:
                  level: 0
                  code: string
                  order: 0
                  parentCode: string
                  name: string
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              examples:
                default:
                  value: null
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: string
                title: string
                status: 0
                detail: string
                instance: string
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: string
                title: string
                status: 0
                detail: string
                instance: 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/correspondenceTables/{correspondenceTable}/maps/{sourceCode}/{targetCode}:
    get:
      tags:
      - CorrespondenceTables
      summary: Returns a correspondencetablemap
      operationId: get-api-classifications-v2-correspondencetables-correspondencetable-maps-sou
      parameters:
      - name: correspondenceTable
        in: path
        description: localId (e.g. `kunta_1_20180101#maakunta_1_20180101`)
        required: true
        schema:
          type: string
          default: ''
      - name: sourceCode
        in: path
        description: Source classification item code (e.g. `941`)
        required: true
        schema:
          type: string
          default: ''
      - name: targetCode
        in: path
        description: Target classification item code (e.g. `21`)
        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/MapMinMin'
              examples:
                default:
                  value: null
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MapMinMin'
              example:
              - distributionSourceToTarget: 0
                distributionTargetToSource: 0
                sourceClassification: string
                targetClassification: string
                sourceItem:
                  level: 0
                  code: string
                  order: 0
                  parentCode: string
                  name: string
                targetItem:
                  level: 0
                  code: string
                  order: 0
                  parentCode: string
                  name: string
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MapMinMin'
              example:
              - distributionSourceToTarget: 0
                distributionTargetToSource: 0
                sourceClassification: string
                targetClassification: string
                sourceItem:
                  level: 0
                  code: string
                  order: 0
                  parentCode: string
                  name: string
                targetItem:
                  level: 0
                  code: string
                  order: 0
                  parentCode: string
                  name: string
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              examples:
                default:
                  value: null
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: string
                title: string
                status: 0
                detail: string
                instance: string
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: string
                title: string
                status: 0
                detail: string
                instance: 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
    CorrespondenceTableText:
      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
        updates:
          maxLength: 300
          type:
          - string
          - 'null'
          description: Updates
      additionalProperties: false
      description: CorrespondenceTableText
    ClassificationItemMinMin:
      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: ClassificationItemMinMin
    CorrespondenceTableMin:
      type: object
      properties:
        source:
          $ref: '#/components/schemas/ClassificationForCorrespondence'
        target:
          $ref: '#/components/schemas/ClassificationForCorrespondence'
        localId:
          maxLength: 220
          type:
          - string
          - 'null'
          description: Local id of correspondence table
        sourceClassification:
          maxLength: 100
          type:
          - string
          - 'null'
          description: Local id of source classification
        targetClassification:
          maxLength: 100
          type:
          - string
          - 'null'
          description: Local id of target classification
        correspondenceTableTexts:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/CorrespondenceTableText'
          description: Correspondence table texts
      additionalProperties: false
      description: CorrespondenceTableMin
    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
    MapMinMin:
      type: object
      properties:
        distributionSourceToTarget:
          type:
          - integer
          - 'null'
          description: 'TODO: Add comment'
          format: int32
        distributionTargetToSource:
          type:
          - integer
          - 'null'
          description: 'TODO: Add comment'
          format: int32
        sourceClassification:
          type:
          - string
          - 'null'
          description: Source classification local Id
        targetClassification:
          type:
          - string
          - 'null'
          description: Target classification local id
        sourceItem:
          $ref: '#/components/schemas/ClassificationItemMinMin'
        targetItem:
          $ref: '#/components/schemas/ClassificationItemMinMin'
      additionalProperties: false
      description: Map-luokka sisältää avainparin tiedot
    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
    CorrespondenceTable:
      type: object
      properties:
        source:
          $ref: '#/components/schemas/ClassificationForCorrespondence'
        target:
          $ref: '#/components/schemas/ClassificationForCorrespondence'
        localId:
          maxLength: 220
          type:
          - string
          - 'null'
          description: Local id of correspondence table
        sourceClassification:
          maxLength: 100
          type:
          - string
          - 'null'
          description: Local id of source classification
        targetClassification:
          maxLength: 100
          type:
          - string
          - 'null'
          description: Local id of target classification
        modifiedDate:
          type: string
          description: Last modified date
          format: date-time
        correspondenceTableTexts:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/CorrespondenceTableText'
          description: Correspondence table texts
      additionalProperties: false
      description: CorrespondenceTable
    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
    ProblemDetails:
      type: object
      properties:
        type:
          type:
          - string
          - 'null'
        title:
          type:
          - string
          - 'null'
        status:
          type:
          - integer
          - 'null'
          format: int32
        detail:
          type:
          - string
          - 'null'
        instance:
          type:
          - string
          - 'null'
      additionalProperties: {}
    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
    ClassificationForCorrespondence:
      type: object
      properties:
        classificationSerie:
          $ref: '#/components/schemas/ClassificationSerie'
        localId:
          maxLength: 100
          type:
          - string
          - 'null'
          description: Local id of classification
        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: ClassificationForCorrespondence is the classification for CorrespondenceTable
  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