Timetable Hearing Statements API Guide

statement

Object

true

statement.statementSender

Object

false

statement.statementSender.emails

Array[String]

true

E-Mail addresses

Length must be between 1 and 10

statement.statementSender.firstName

String

true

First Name

Example value: Fabienne

Length must be between 0 and 100

statement.statementSender.lastName

String

true

Last Name

Example value: Maurer

Length must be between 0 and 100

statement.statementSender.organisation

String

true

Organisation

Example value: Post AG

Length must be between 0 and 100

statement.statementSender.street

String

true

Street

Example value: Bahnhofstrasse 12

Length must be between 0 and 100

statement.statementSender.zip

Integer

true

ZIP Code

Example value: 3000

statement.statementSender.city

String

true

City

Example value: Bern

Length must be between 0 and 50

statement.id

Integer

true

Technical identifier

Example value: 1

statement.timetableYear

Integer

true

TimetableYear

Example value: 2024

statement.statementStatus

String

true

Current status

Must be one of ["RECEIVED","IN_REVIEW","ACCEPTED","PARTLY_IMPLEMENTED","NOTED","REJECTED","MOVED","JUNK","REVOKED"]

statement.ttfnid

String

true

TimetableFieldNumberId regarding the statement

Example value: ch:1:ttfnid:123234

statement.timetableFieldNumber

String

true

Timetable field number

Example value: 100; 80.099; 2700

statement.timetableFieldDescription

String

true

Timetable field number description

Example value: Fribourg/Freiburg - Bern - Thun (S-Bahn Bern, Linien S1, S2)

statement.swissCanton

String

false

Canton, the statement is for

Must be one of ["ZURICH","BERN","LUCERNE","URI","SCHWYZ","OBWALDEN","NIDWALDEN","GLARUS","ZUG","FRIBOURG","SOLOTHURN","BASEL_CITY","BASEL_COUNTRY","SCHAFFHAUSEN","APPENZELL_AUSSERRHODEN","APPENZELL_INNERRHODEN","ST_GALLEN","GRAUBUNDEN","AARGAU","THURGAU","TICINO","VAUD","VALAIS","NEUCHATEL","GENEVE","JURA"]

statement.oldSwissCanton

String

true

Canton, the statement was before

Must be one of ["ZURICH","BERN","LUCERNE","URI","SCHWYZ","OBWALDEN","NIDWALDEN","GLARUS","ZUG","FRIBOURG","SOLOTHURN","BASEL_CITY","BASEL_COUNTRY","SCHAFFHAUSEN","APPENZELL_AUSSERRHODEN","APPENZELL_INNERRHODEN","ST_GALLEN","GRAUBUNDEN","AARGAU","THURGAU","TICINO","VAUD","VALAIS","NEUCHATEL","GENEVE","JURA"]

statement.stopPlace

String

true

StopPlace information for the statement

Example value: Bern, Wyleregg

Length must be between 0 and 255

statement.responsibleTransportCompanies

Array[Object]

true

statement.responsibleTransportCompanies[].id

Integer

true

Technical identifier

Example value: 1

statement.responsibleTransportCompanies[].number

String

true

TransportCompany number

Example value: \#0001

statement.responsibleTransportCompanies[].abbreviation

String

true

TransportCompany abbreviation

Example value: SBB

statement.responsibleTransportCompanies[].businessRegisterName

String

true

TransportCompany business register name

Example value: Schweizerische Bundesbahnen SBB

statement.responsibleTransportCompaniesDisplay

String

true

Comma separated Transport Companies abbreviation

Example value: BLS,SBB

statement.statement

String

false

Statement of citizen

Example value: I need some more busses please.

Length must be between 0 and 5000

statement.documents

Array[Object]

true

List of uploaded documents

Length must be between 0 and 3

statement.documents[].id

Integer

true

Technical identifier

Example value: 1

statement.documents[].fileName

String

false

FileName of uploaded document

Example value: Document.pdf

Length must be between 0 and 500

statement.documents[].fileSize

Integer

false

Content length

Example value: 1123123

statement.justification

String

true

Statement of Federal office of transport

Example value: We can absolutely do that.

Length must be between 0 and 5000

statement.comment

String

true

Statement comment

Example value: I am changing my statement from the canton Geneva to the canton Bern.

Length must be between 0 and 280

statement.etagVersion

Integer

true

Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3)

Example value: 5

statement.creationDate

String

true

Object creation date

Example value: 01.01.2000

statement.creator

String

true

User creator

Example value: u123456

statement.editionDate

String

true

Last edition date

Example value: 01.01.2000

statement.editor

String

true

User editor

Example value: u123456

statement.status

String

true

Status

Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

documents

Array[File]

true