Digitraffic (Fintraffic) Weathercam V1 API

Weather cameras

GitHub OpenAPI

Operations 7

GET /api/weathercam/v1/stations The static information of weather camera stations #
GET /api/weathercam/v1/stations/{id} The static information of weather camera station #
GET /api/weathercam/v1/stations/{id}/history Weathercam presets history for given camera #
GET /api/weathercam/v1/stations/{id}/data Current data of weathercam #
GET /api/weathercam/v1/stations/history Weathercams presets history for all cameras #
GET /api/weathercam/v1/stations/data Current data of weathercams #
GET /api/weathercam/v1/publicities/changes Weathercam presets publicity changes after given time. #

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/digitraffic-fi:digitraffic-fi-weathercam-v1-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.

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

OpenAPI Specification

digitraffic-fi-weathercam-v1-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Digitraffic Road Weathercam V1 API
  version: 'Branch: master, tag: 2026.11.2-1 #ae693ff @ 2026-11-03T08:05:21+0000'
  description: 'OpenAPI document


    Digitraffic is a service operated by Fintraffic, offering real time traffic information. Currently the service covers *road, marine and rail* traffic. More information can be found at the Digitraffic website


    The service has a public Google-group road.digitraffic.fi for communication between developers, service administrators and Fintraffic. The discussion in the forum is mostly in Finnish, but you''re welcome to communicate in English too.


    ### General notes of the API

    * Many Digitraffic APIs use the GeoJSON format. The definition of GeoJSON can be found at https://tools.ietf.org/html/rfc7946.

    * For dates and times, the ISO 8601 format is used with "Zulu" zero offset from UTC unless otherwise specified (i.e., "yyyy-mm-ddThh:mm:ss[.mmm]Z"). E.g. 2019-11-01T06:30:00Z.'
  termsOfService: https://www.digitraffic.fi/en/terms-of-service/
  contact:
    name: Digitraffic / Fintraffic
    url: https://www.digitraffic.fi/
  license:
    name: Creative Commons 4.0 BY
    url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://tie.digitraffic.fi
tags:
- name: Weathercam V1
  description: Weather cameras
  externalDocs:
    description: Documentation
    url: https://www.digitraffic.fi/en/road-traffic/#weather-cameras
paths:
  /api/weathercam/v1/stations:
    get:
      tags:
      - Weathercam V1
      summary: The static information of weather camera stations
      operationId: weathercamStations
      parameters:
      - name: lastUpdated
        in: query
        description: If parameter is given result will only contain update status.
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Successful retrieval of Camera Preset Feature Collections
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationFeatureCollectionSimpleV1'
            application/geo+json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationFeatureCollectionSimpleV1'
            application/vnd.geo+json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationFeatureCollectionSimpleV1'
  /api/weathercam/v1/stations/{id}:
    get:
      tags:
      - Weathercam V1
      summary: The static information of weather camera station
      operationId: weathercamStation
      parameters:
      - name: id
        in: path
        description: Weathercam station id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationFeatureV1Detailed'
            application/geo+json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationFeatureV1Detailed'
            application/vnd.geo+json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationFeatureV1Detailed'
  /api/weathercam/v1/stations/{id}/history:
    get:
      tags:
      - Weathercam V1
      summary: Weathercam presets history for given camera
      operationId: getWeathercamPresetsHistoryById
      parameters:
      - name: id
        in: path
        description: Camera id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful retrieval of weathercam image history
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/PresetHistory'
  /api/weathercam/v1/stations/{id}/data:
    get:
      tags:
      - Weathercam V1
      summary: Current data of weathercam
      operationId: weathercamDatasByStationId
      parameters:
      - name: id
        in: path
        description: Camera station id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful retrieval of camera station data
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationDataV1'
  /api/weathercam/v1/stations/history:
    get:
      tags:
      - Weathercam V1
      summary: Weathercams presets history for all cameras
      operationId: getWeathercamsPresetsHistory
      responses:
        '200':
          description: Successful retrieval of weathercams image history
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/CameraHistory'
  /api/weathercam/v1/stations/data:
    get:
      tags:
      - Weathercam V1
      summary: Current data of weathercams
      operationId: weathercamsDatas
      parameters:
      - name: lastUpdated
        in: query
        description: If parameter is given result will only contain update status.
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Successful retrieval of camera station data
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationsDataV1'
  /api/weathercam/v1/publicities/changes:
    get:
      tags:
      - Weathercam V1
      summary: Weathercam presets publicity changes after given time.
      operationId: weathercamPresetPublicityChangesAfter
      parameters:
      - name: after
        in: query
        description: Return changes int the history after given time. Given time must be within 24 hours. Default is 24h in past
        required: false
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: Successful retrieval of camera history changes
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WeathercamStationsPresetsPublicityHistoryV1'
components:
  schemas:
    WeathercamStationFeatureSimpleV1:
      required:
      - geometry
      - id
      - properties
      - type
      type: object
      properties:
        type:
          type: string
          description: GeoJSON Object Type
        id:
          type: string
          description: Id of the road station
        geometry:
          $ref: '#/components/schemas/Point'
        properties:
          $ref: '#/components/schemas/WeathercamStationPropertiesSimpleV1'
      description: Weathercam station GeoJSON Feature object with basic information
    WeathercamPresetDataV1:
      required:
      - id
      - measuredTime
      type: object
      properties:
        id:
          type: string
          description: Id of the weathercam preset
        measuredTime:
          type: string
          description: Latest measurement time
          format: date-time
      description: Weathercam preset's latest image capture data
    CameraHistory:
      required:
      - dataUpdatedTime
      type: object
      properties:
        dataUpdatedTime:
          type: string
          description: Time when data was last updated
          format: date-time
        stations:
          type: array
          description: Stations data
          items:
            $ref: '#/components/schemas/PresetHistory'
      description: Weather camera's image history details.
    WeathercamStationsDataV1:
      required:
      - dataUpdatedTime
      type: object
      properties:
        dataUpdatedTime:
          type: string
          description: Time when data was last updated
          format: date-time
        stations:
          type: array
          description: Stations data
          items:
            $ref: '#/components/schemas/WeathercamStationDataV1'
      description: Weathercam stations' data
    WeathercamStationFeatureV1Detailed:
      required:
      - geometry
      - id
      - properties
      - type
      type: object
      properties:
        type:
          type: string
          description: GeoJSON Object Type
        id:
          type: string
          description: Id of the road station
        geometry:
          $ref: '#/components/schemas/Point'
        properties:
          $ref: '#/components/schemas/WeathercamStationPropertiesDetailedV1'
      description: ' Weathercam station GeoJSON feature object with detailed information'
    WeathercamPresetHistoryDtoV1:
      required:
      - history
      - id
      type: object
      properties:
        id:
          type: string
          description: Weathercam preset's id
        dataUpdatedTime:
          type: string
          description: Time when data was last updated
          format: date-time
        history:
          type: array
          description: Weathercam preset's history
          items:
            $ref: '#/components/schemas/WeathercamPresetHistoryItemDtoV1'
      description: Weather camera preset's image history.
    WeathercamStationPropertiesSimpleV1:
      required:
      - id
      type: object
      properties:
        id:
          type: string
          description: Id of the road station
        name:
          type: string
          description: Common name of road station
        collectionStatus:
          type: string
          description: Data collection status
          enum:
          - GATHERING
          - REMOVED_TEMPORARILY
          - REMOVED_PERMANENTLY
        state:
          type: string
          description: Road station state
          enum:
          - OK
          - OK_FAULT_DOUBT_CANCELLED
          - FAULT_DOUBT
          - FAULT_CONFIRMED
          - FAULT_CONFIRMED_NOT_FIXED_IN_NEAR_FUTURE
          - REPAIR_REQUEST_POSTED
          - REPAIR_MAINTENANCE_DONE
          - REPAIR_INTERRUPTED
        dataUpdatedTime:
          type: string
          description: Date time of the most recent metadata update
          format: date-time
        presets:
          type: array
          description: Weathercam presets
          items:
            $ref: '#/components/schemas/WeathercamPresetSimpleV1'
      description: Weathercam station properties object with basic information
    WeathercamPresetHistoryItemDtoV1:
      type: object
      properties:
        lastModified:
          type: string
          description: Last modified date of the image.
          format: date-time
        imageUrl:
          type: string
          description: Url to read the image.
        sizeBytes:
          type: integer
          description: Image size in bytes.
          format: int32
      description: Weather camera preset's image history details.
    GeometryObject:
      required:
      - coordinates
      - type
      type: object
      properties:
        type:
          type: string
          description: GeoJson Geometry Object type
          enum:
          - Point
          - LineString
          - Polygon
          - MultiPoint
          - MultiLineString
          - MultiPolygon
        coordinates:
          type: array
          description: GeoJson Geometry Object coordinates
          items:
            type: object
            description: GeoJson Geometry Object coordinates
      description: GeoJson Geometry Object
      discriminator:
        propertyName: type
    WeathercamPresetDetailedV1:
      required:
      - direction
      - directionCode
      type: object
      properties:
        id:
          type: string
          description: Id of preset
        presentationName:
          type: string
          description: PresentationName (Preset name 1, direction)
        inCollection:
          type: boolean
          description: Is preset in collection
        resolution:
          type: string
          description: Resolution of camera [px x px]
        directionCode:
          type: string
          description: 'Preset direction:<br>

            0 = Unknown direction.<br>

            1 = According to the road register address increasing direction. I.e. on the road 4 to Lahti, if we are in Korso.<br>

            2 = According to the road register address decreasing direction. I.e. on the road 4 to Helsinki, if we are in Korso.<br>

            3 = Increasing direction of the crossing road.<br>

            4 = Decreasing direction of the crossing road.<br>

            5-99 = Special directions'
        imageUrl:
          type: string
          description: Image url
        direction:
          $ref: '#/components/schemas/WeathercamPresetDirectionV1'
      description: Weathercam preset object with detailed information
    WeathercamPresetSimpleV1:
      type: object
      properties:
        id:
          type: string
          description: Id of preset
        inCollection:
          type: boolean
          description: Is preset in collection
      description: Weathercam preset object with basic information
    WeathercamPresetDirectionV1:
      type: string
      description: Weathercam preset direction
      default: UNKNOWN
      enum:
      - UNKNOWN
      - INCREASING_DIRECTION
      - DECREASING_DIRECTION
      - CROSSING_ROAD_INCREASING_DIRECTION
      - CROSSING_ROAD_DECREASING_DIRECTION
      - SPECIAL_DIRECTION
    WeathercamStationFeatureCollectionSimpleV1:
      required:
      - dataUpdatedTime
      - features
      - type
      type: object
      properties:
        type:
          type: string
          description: GeoJSON Object Type
        dataUpdatedTime:
          type: string
          description: Date time of the most recent metadata update
          format: date-time
        features:
          type: array
          description: GeoJSON Feature Objects
          items:
            $ref: '#/components/schemas/WeathercamStationFeatureSimpleV1'
      description: Weathercam GeoJSON FeatureCollection object with basic information
    WeathercamStationsPresetsPublicityHistoryV1:
      type: object
      properties:
        dataUpdatedTime:
          type: string
          description: Latest history change time. Use this value as parameter for next query in api.
          format: date-time
        stations:
          type: array
          description: Stations data
          items:
            $ref: '#/components/schemas/WeathercamStationPresetsPublicityHistoryV1'
      description: Weathercam stations presets publicity changes
    WeathercamStationPresetsPublicityHistoryV1:
      required:
      - id
      - presets
      type: object
      properties:
        id:
          type: string
          description: Id of the road station
        dataUpdatedTime:
          type: string
          description: Time when data was last updated
          format: date-time
        presets:
          type: array
          description: Id of the weathercam station
          items:
            $ref: '#/components/schemas/WeathercamPresetPublicityHistoryV1'
      description: Weathercam station presets publicity changes
    PresetHistory:
      required:
      - id
      - presets
      type: object
      properties:
        id:
          type: string
          description: Id of the road station
        dataUpdatedTime:
          type: string
          description: Time when data was last updated
          format: date-time
        presets:
          type: array
          description: Weathercam presets histories
          items:
            $ref: '#/components/schemas/WeathercamPresetHistoryDtoV1'
      description: Weather camera preset's image history.
    WeathercamStationDataV1:
      required:
      - id
      - presets
      type: object
      properties:
        id:
          type: string
          description: Id of the road station
        dataUpdatedTime:
          type: string
          description: Time when data was last updated
          format: date-time
        presets:
          type: array
          description: Weathercam presets data
          items:
            $ref: '#/components/schemas/WeathercamPresetDataV1'
      description: Weathercam stations' data
    StationRoadAddressV1:
      type: object
      properties:
        roadNumber:
          type: integer
          description: Road number (values 1–99999)
          format: int32
          example: 7
        roadSection:
          type: integer
          description: Road section (values 1–999)
          format: int32
          example: 8
        distanceFromRoadSectionStart:
          type: integer
          description: Distance from start of the road portion [m]
          format: int32
          example: 3801
        carriageway:
          type: string
          description: 'Carriageway <br>ONE_CARRIAGEWAY:                                0 = One carriageway road section <br>DUAL_CARRIAGEWAY_RIGHT_IN_INCREASING_DIRECTION: 1 = Dual carriageway''s right carriageway on increasing direction <br>DUAL_CARRIAGEWAY_LEFT_IN_INCREASING_DIRECTION:  2 = Dual carriageway''s left carriageway on increasing direction (upstream)'
          enum:
          - ONE_CARRIAGEWAY
          - DUAL_CARRIAGEWAY_RIGHT_IN_INCREASING_DIRECTION
          - DUAL_CARRIAGEWAY_LEFT_IN_INCREASING_DIRECTION
        side:
          type: string
          description: 'Road address side information <br>* UNKNOWN: 0 = Unknown, <br>* RIGHT    1 = On the right side of the carriageway in the increasing direction, <br>* LEFT:    2 = On the left side of the carriageway in the increasing direction, <br>* BETWEEN: 3 = Between the carriageways, <br>* END:     7 = At the end of the road, <br>* MIDDLE:  8 = In the middle of the carriageway / on the carriageway, <br>* CROSS:   9 = Across the road'
          enum:
          - UNKNOWN
          - RIGHT
          - LEFT
          - BETWEEN
          - END
          - MIDDLE
          - CROSS
        contractArea:
          type: string
          description: Road contract area
          example: Espoo 19-24
        contractAreaCode:
          type: integer
          description: Road contract area code
          format: int32
          example: 142
      description: Road station road address
    WeathercamPresetPublicityHistoryV1:
      required:
      - id
      type: object
      properties:
        id:
          type: string
          description: Id of the weathercam preset
        measuredTime:
          type: string
          description: The time when change took place. Same as the last modified date of the related image version.
          format: date-time
        publishableTo:
          type: boolean
          description: New state for publicity
        modifiedTime:
          type: string
          description: Modification time of the history.
          format: date-time
      description: Weathercam station preset's publicity changes
    Point:
      required:
      - coordinates
      - type
      type: object
      description: GeoJson Point Geometry Object
      allOf:
      - $ref: '#/components/schemas/GeometryObject'
      - type: object
        properties:
          type:
            type: string
            example: Point
            enum:
            - Point
          coordinates:
            type: array
            description: 'An array of coordinates. Coordinates are in WGS84 format in decimal degrees: [LONGITUDE, LATITUDE, {ALTITUDE}]. Altitude is optional and measured in meters.'
            example:
            - 26.97677492
            - 65.3467385
            items:
              type: number
              description: 'An array of coordinates. Coordinates are in WGS84 format in decimal degrees: [LONGITUDE, LATITUDE, {ALTITUDE}]. Altitude is optional and measured in meters.'
              format: double
    WeathercamStationPropertiesDetailedV1:
      required:
      - id
      type: object
      properties:
        id:
          type: string
          description: Id of the road station
        name:
          type: string
          description: Common name of road station
        cameraType:
          type: string
          description: Type of camera
          enum:
          - VAPIX
          - VMX_MPC
          - VMX_MPH
          - D_LINK
          - ZAVIO
          - ENEO
          - BOSCH
          - SONY
          - HIKVISION
          - OLD
        nearestWeatherStationId:
          type: integer
          description: Nearest weather station id
          format: int64
        collectionStatus:
          type: string
          description: Data collection status
          enum:
          - GATHERING
          - REMOVED_TEMPORARILY
          - REMOVED_PERMANENTLY
        state:
          type: string
          description: Road station state
          enum:
          - OK
          - OK_FAULT_DOUBT_CANCELLED
          - FAULT_DOUBT
          - FAULT_CONFIRMED
          - FAULT_CONFIRMED_NOT_FIXED_IN_NEAR_FUTURE
          - REPAIR_REQUEST_POSTED
          - REPAIR_MAINTENANCE_DONE
          - REPAIR_INTERRUPTED
        dataUpdatedTime:
          type: string
          description: Date time of the most recent metadata update
          format: date-time
        collectionInterval:
          type: integer
          description: Data collection interval [s]
          format: int32
        names:
          type: object
          additionalProperties:
            type: string
            description: Map of names [fi, sv, en]
            example: '{"fi":"Tie 7 Porvoo, Harabacka","sv":"Väg 7 Borgå, Harabacka","en":"Road 7 Porvoo, Harabacka"}'
          description: Map of names [fi, sv, en]
          example:
            fi: Tie 7 Porvoo, Harabacka
            sv: Väg 7 Borgå, Harabacka
            en: Road 7 Porvoo, Harabacka
        roadAddress:
          $ref: '#/components/schemas/StationRoadAddressV1'
        liviId:
          type: string
          description: Id in road registry
        country:
          type: string
          description: Country where station is located
        startTime:
          type: string
          description: Station established date time
          format: date-time
        repairMaintenanceTime:
          type: string
          description: Repair maintenance date time
          format: date-time
        annualMaintenanceTime:
          type: string
          description: Annual maintenance date time
          format: date-time
        purpose:
          type: string
          description: Purpose of the road station
        municipality:
          type: string
          description: Municipality
        municipalityCode:
          type: integer
          description: Municipality code
          format: int32
        province:
          type: string
          description: Province
        provinceCode:
          type: integer
          description: Province code
          format: int32
        presets:
          type: array
          description: Weathercam presets
          items:
            $ref: '#/components/schemas/WeathercamPresetDetailedV1'
      description: Weathercam station properties object with detailed information