Digitraffic (Fintraffic)

Digitraffic (Fintraffic) Passenger Information API

The passenger-information API from Digitraffic (Fintraffic) — 2 operation(s) for passenger-information.

Documentation GitHub OpenAPI

Operations 2

GET /api/v1/passenger-information/active Get currently active passenger information messages #

GET /api/v1/passenger-information/updated-after/{date} Get messages updated after date #

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-passenger-information-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: rata.digitraffic.fi Passenger Information API
  version: '1.0'
  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 rail.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://rata.digitraffic.fi
tags:
- name: passenger-information
paths:
  /api/v1/passenger-information/active:
    get:
      tags:
      - passenger-information
      summary: Get currently active passenger information messages
      parameters:
      - name: station
        in: query
        description: Station identifier, for example _HKI_
        schema:
          type: string
      - name: train_departure_date
        in: query
        description: Train departure date in format YYYY-MM-DD
        schema:
          type: string
      - name: train_number
        in: query
        description: Train number
        schema:
          type: string
      - name: only_general
        in: query
        description: If _true_, return only general notices (notices not related to a train number). _false_ by default
        schema:
          type: string
      responses:
        '200':
          description: 200 response
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PassengerInformationMessages'
        '400':
          description: 400 response
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponseModel'
      operationId: getApiV1PassengerInformationActive
      x-operation-id-source: derived
  /api/v1/passenger-information/updated-after/{date}:
    get:
      tags:
      - passenger-information
      summary: Get messages updated after date
      parameters:
      - name: date
        in: path
        description: Date or date-time on or after which message was created or updated. For example _2023-01-01_ or _2023-01-01T12:00Z_
        required: true
        schema:
          type: string
      - name: station
        in: query
        description: Station identifier, for example _HKI_
        schema:
          type: string
      - name: train_departure_date
        in: query
        description: Train departure date in format YYYY-MM-DD
        schema:
          type: string
      - name: train_number
        in: query
        description: Train number
        schema:
          type: string
      - name: only_active
        in: query
        description: If _true_, return only currently active messages. _false_ returns all messages updated after _{date}_ regardless of validity dates. _true_ by default
        schema:
          type: string
      - name: only_general
        in: query
        description: If _true_, return only general notices (notices not related to a train number). _false_ by default
        schema:
          type: string
      responses:
        '200':
          description: 200 response
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PassengerInformationMessages'
        '400':
          description: 400 response
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponseModel'
      operationId: getApiV1PassengerInformationUpdatedAfterByDate
      x-operation-id-source: derived
components:
  schemas:
    PassengerInformationVideo:
      type: object
      properties:
        text:
          $ref: '#/components/schemas/PassengerInformationTextContent'
        deliveryRules:
          type: object
          properties:
            startDateTime:
              type: string
              description: Video delivery start date
            weekDays:
              type: array
              description: Days of week on which video is delivered
              items:
                type: string
                enum:
                - MONDAY
                - TUESDAY
                - WEDNESDAY
                - THURSDAY
                - FRIDAY
                - SATURDAY
                - SUNDAY
            deliveryType:
              type: string
              description: "CONTINUOS_VISUALIZATION: the message is delivered from _startDateTime_ (at _startTime_ if exists) to _endDateTime_ (at _endTime_ if exists) \n WHEN: the message is delivered  from  _startDateTime_ to _endDateTime_ only in the time interval between _startTime_ and _endTime_ for each day in _weekDays_"
              enum:
              - WHEN
              - CONTINUOS_VISUALIZATION
            startTime:
              type: string
              description: Video delivery start time
            endTime:
              type: string
              description: Video delivery end time
            endDateTime:
              type: string
              description: Video delivery end date
      description: PassengerInformation message video content schema
    MessageResponseModel:
      type: object
      properties:
        message:
          type: string
          description: Response message
      description: Response with message
    PassengerInformationTextContent:
      type: object
      properties:
        fi:
          type: string
          description: Message text content in Finnish
        sv:
          type: string
          description: Message text content in Swedish
        en:
          type: string
          description: Message text content in English
      description: PassengerInformation message text content schema
    PassengerInformationAudio:
      type: object
      properties:
        text:
          $ref: '#/components/schemas/PassengerInformationTextContent'
        deliveryRules:
          type: object
          properties:
            startDateTime:
              type: string
              description: Audio delivery start date
            weekDays:
              type: array
              description: Days of week on which audio is delivered
              items:
                type: string
                enum:
                - MONDAY
                - TUESDAY
                - WEDNESDAY
                - THURSDAY
                - FRIDAY
                - SATURDAY
                - SUNDAY
            deliveryType:
              type: string
              description: "NOW: the message is delivered at the time of insertion \n DELIVERY_AT: the message is delivered on the date-time _deliveryAt_ \n REPEAT_EVERY: the message is delivered from _startDateTime_ at _startTime_ to _endDateTime_ at _endTime_ evaluating the repetition conditions and _weekDays_ conditions \n ON_SCHEDULE: the message is delivered for a specific vehicle journey when a scheduling date happens at a station (e.g. estimated arrival time) \n ON_EVENT: the message is delivered for a vehicle journey when an event specified in _eventType_ (e.g. ARRIVING) happens for a station defined in _stations_"
              enum:
              - NOW
              - DELIVERY_AT
              - REPEAT_EVERY
              - ON_EVENT
              - ON_SCHEDULE
            startTime:
              type: string
              description: Audio delivery start time
            deliveryAt:
              type: string
              description: Date and time on which message is delivered when _deliveryType_ is DELIVERY_AT
            repeatEvery:
              type: integer
              description: Period of time in minutes between repetitions of message when  _deliveryType_ is REPEAT_EVERY
            endTime:
              type: string
              description: Audio delivery end time
            eventType:
              type: string
              description: Event type on which message is delivered when _deliveryType_ is ON_EVENT
              enum:
              - ARRIVING
              - DEPARTING
            endDateTime:
              type: string
              description: Audio delivery end date
            repetitions:
              type: integer
              description: Number of times message is repeated on each occurrence when  _deliveryType_ is REPEAT_EVERY
      description: PassengerInformation message audio content schema
    PassengerInformationMessages:
      type: array
      items:
        $ref: '#/components/schemas/PassengerInformationMessage'
    PassengerInformationMessage:
      required:
      - creationDateTime
      - endValidity
      - id
      - startValidity
      - version
      type: object
      properties:
        trainDepartureDate:
          type: string
          description: Date of departure as a local date for train to which message relates
        endValidity:
          type: string
          description: Message validity end date and time
        startValidity:
          type: string
          description: Message validity start date and time
        id:
          type: string
        stations:
          type: array
          description: List of stations where message is delivered
          items:
            type: string
        trainNumber:
          type: string
          description: Number of train to which message relates
        audio:
          $ref: '#/components/schemas/PassengerInformationAudio'
        video:
          $ref: '#/components/schemas/PassengerInformationVideo'
        version:
          type: number
        creationDateTime:
          type: string
          description: Date and time when message version was created
      description: PassengerInformation message schema