Digitraffic (Fintraffic) SSE V1 API

openapi: 3.2.0
info:
  title: Digitraffic Marine SSE V1 API
  version: 'Branch: master, tag: 2026.11.2-1 #0bde4c1 @ 2026-11-03T08:19: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 meri.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://meri.digitraffic.fi
tags:
- name: SSE V1
  description: Sea State Estimate (SSE) APIs
paths:
  /api/sse/v1/measurements:
    get:
      tags:
      - SSE V1
      summary: Return Sea State Estimation (SSE) data as GeoJSON.
      operationId: measurements
      parameters:
      - name: siteNumber
        in: query
        description: SSE site number
        required: false
        schema:
          type: integer
          format: int32
      - name: from
        in: query
        description: Return SSE data after given time in ISO date format {yyyy-MM-dd'T'HH:mm:ss.SSSZ} e.g. 2019-06-01T01:30:00.000Z
        required: false
        schema:
          type: string
          format: date-time
        example: '2019-06-01T01:30:00.000Z'
      - name: to
        in: query
        description: Return SSE data before given time in ISO date format {yyyy-MM-dd'T'HH:mm:ss.SSSZ} e.g. 2019-06-30T01:30:00.000Z
        required: false
        schema:
          type: string
          format: date-time
        example: '2019-06-30T01:30:00.000Z'
      responses:
        '200':
          description: OK
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/SseFeatureCollectionV1'
            application/geo+json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/SseFeatureCollectionV1'
            application/vnd.geo+json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/SseFeatureCollectionV1'
      deprecated: true
components:
  schemas:
    SseFeatureV1:
      required:
      - geometry
      - properties
      type: object
      properties:
        siteNumber:
          type: integer
          description: Identifier of the site
          format: int32
        type:
          type: string
          description: GeoJSON object type
        geometry:
          $ref: '#/components/schemas/Point'
        properties:
          $ref: '#/components/schemas/SsePropertiesV1'
        additionalProperties:
          type: object
          additionalProperties:
            type: object
      description: GeoJSON Feature object of sea state estimate (SSE)
    Point:
      required:
      - coordinates
      - type
      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
        additionalProperties:
          type: object
          additionalProperties:
            type: object
      description: GeoJSON Point Geometry object
    SseFeatureCollectionV1:
      required:
      - dataUpdatedTime
      - features
      type: object
      properties:
        type:
          type: string
          description: GeoJSON object type
        dataUpdatedTime:
          type: string
          description: Data last updated time
          format: date-time
        features:
          type: array
          items:
            $ref: '#/components/schemas/SseFeatureV1'
        additionalProperties:
          type: object
          additionalProperties:
            type: object
      description: GeoJSON FeatureCollection object of sea state estimate (SSE)
    SsePropertiesV1:
      required:
      - confidence
      - lastUpdate
      - siteName
      - siteType
      type: object
      properties:
        siteNumber:
          type: integer
          description: Identifier of the site
          format: int32
        siteName:
          type: string
          description: Site name of the buoy
        siteType:
          type: string
          description: Type of the site. FLOATING is floating in the water and FIXED it is standing on the ground.
          enum:
          - FIXED
          - FLOATING
        lastUpdate:
          type: string
          description: Data last updated timestamp in ISO 8601 format with time offsets from UTC (eg. 2016-04-20T12:38:16.328+03:00 or 2018-11-09T09:41:09Z)
          format: date-time
        seaState:
          type: string
          description: Sea state. If seaState is CALM, the windWaveDir is not reliable. This field is available only for FLOATING siteType
          enum:
          - CALM
          - LIGHT
          - MODERATE
          - BREEZE
          - GALE
          - STORM
        trend:
          type: string
          description: Trend of condition change. This field is available only for FLOATING siteType
          enum:
          - UNKNOWN
          - NO_CHANGE
          - ASCENDING
          - DESCENDING
        windWaveDir:
          type: integer
          description: Wind and wave direction in degrees from north. If seaState is CALM, the windWaveDir is not reliable. This field is available only for FLOATING siteType
          format: int32
          enum:
          - null
        confidence:
          type: string
          description: 'Provides information on estimated confidence of mainly the directional information based on the Horizontal Dilution of precision (HDOP) figure obtained from the GPS receiver:

            * POOR: More than 10

            * MODERATE: 2-10

            * GOOD: Less than 2'
          enum:
          - POOR
          - MODERATE
          - GOOD
        heelAngle:
          type: number
          description: Heel angle of the buoy in degrees (°), 0 is upright and it´s unsigned. This field is available only for FLOATING siteType
          enum:
          - null
        lightStatus:
          type: string
          description: Status of the flashlight. Normally ON at nighttime and OFF at daytime. ON_D means that light characteristics are alternated (ie. intensity and frequency) compared to normal ON operation, used normally on daytime.
          enum:
          - 'ON'
          - 'OFF'
          - ON_D
        temperature:
          type: integer
          description: Temperature of the air in celsius degree (°C). Since the sensor is inside of the buoy and sunlight can heat up the enclosure this can be used only as a reference measurement as it can show higher readings than the actual air temperature
          format: int32
      description: GeoJSON Properties object of sea state estimate (SSE)