SLF Logo
API docs by Redocly

SLF - Bulletin API (4.0)

Download OpenAPI specification:

SLF data service: data@slf.ch URL: https://www.slf.ch/en/services-and-products/slf-data-service/ License: CC BY 4.0

API for querying the bulletin.

V3 (default)

The default service version

Active bulletin as geojson

Returns the bulletin active at the specified time.

  • If no time is specified, 'Now' is assumed as the time
  • If no active bulletin exists, the features list will be empty.

path Parameters
lang
required
string
Enum: "de" "fr" "it" "en"
Example: de

Desired language. If the desired language does not exists, a german bulletin will be returned

query Parameters
activeAt
string <date-time>
Example: activeAt=2018-04-06T01:00:00+02:00

Timestamp, to search for active bulletins.

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "metaData": {
    },
  • "customData": {
    }
}

Active bulletin as caamlV6

Returns the bulletin active at the specified time.

  • If no time is specified, 'Now' is assumed as the time
  • If no active bulletin exists, the bulletins list will be empty.

path Parameters
lang
required
string
Enum: "de" "fr" "it" "en"
Example: de

Desired language. If the desired language does not exists, a german bulletin will be returned

query Parameters
activeAt
string <date-time>
Example: activeAt=2018-04-06T01:00:00+02:00

Timestamp, to search for active bulletins.

Responses

Response samples

Content type
application/json
{
  • "bulletins": [
    ],
  • "metaData": {
    },
  • "customData": {
    }
}

V4

Release Notes

  • The value type of elevation lower and upper bound is now a string instead of number.
  • The full montain is now represented as an empty elevation object "elevation": {} instead of "elevation": {"lowerBound": 0, "upperBound":null}
  • With the exception of the empty elevation object, all empty values such as empty strings "" , null or empty objects ({}) have been removed recursively
    For example:
    {"mainValue": "low", "elevation": null, "aspects": [], "validTimePeriod": "all_day", "customData": {"CH": {"subdivision": null}}}
    is now renderd as
    {"mainValue": "low", "validTimePeriod": "all_day"}

Active bulletin as geojson

Returns the bulletin active at the specified time.

  • If no time is specified, 'Now' is assumed as the time
  • If no active bulletin exists, the features list will be empty.

path Parameters
lang
required
string
Enum: "de" "fr" "it" "en"
Example: de

Desired language. If the desired language does not exists, a german bulletin will be returned

query Parameters
activeAt
string <date-time>
Example: activeAt=2018-04-06T01:00:00+02:00

Timestamp, to search for active bulletins.

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "metaData": {
    },
  • "customData": {
    }
}

Active bulletin as caamlV6

Returns the bulletin active at the specified time.

  • If no time is specified, 'Now' is assumed as the time
  • If no active bulletin exists, the bulletins list will be empty.

path Parameters
lang
required
string
Enum: "de" "fr" "it" "en"
Example: de

Desired language. If the desired language does not exists, a german bulletin will be returned

query Parameters
activeAt
string <date-time>
Example: activeAt=2018-04-06T01:00:00+02:00

Timestamp, to search for active bulletins.

Responses

Response samples

Content type
application/json
{
  • "bulletins": [
    ],
  • "metaData": {
    },
  • "customData": {
    }
}

Bulletin Preview

Preview of unreleased avalanche bulletins

Bulletin preview as caamlV6

Returns the bulletin preview active at the specified time.

  • If no time is specified, 'Now' is assumed as the time
  • If no bulletin draft exists, the bulletins list will be empty.

Authorizations:
bearer_auth
path Parameters
lang
required
string
Enum: "de" "fr" "it" "en"
Example: de

Desired language. If the desired language does not exists, a german bulletin will be returned

query Parameters
activeAt
string <date-time>
Example: activeAt=2018-04-06T01:00:00+02:00

Timestamp, to search for bulletins preview.

Responses

Response samples

Content type
application/json
{
  • "bulletins": [
    ],
  • "metaData": {
    },
  • "customData": {
    }
}

Bulletin preview as geojson

Returns the bulletin preview active at the specified time.

  • If no time is specified, 'Now' is assumed as the time
  • If no active bulletin exists, the bulletins list will be empty.

Authorizations:
bearer_auth
path Parameters
lang
required
string
Enum: "de" "fr" "it" "en"
Example: de

Desired language. If the desired language does not exists, a german bulletin will be returned

query Parameters
activeAt
string <date-time>
Example: activeAt=2018-04-06T01:00:00+02:00

Timestamp, to search for bulletin preview.

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "metaData": {
    },
  • "customData": {
    }
}

Bulletin List

List of released avalanche bulletins

Released bulletin as caamlV6

Returns a list of released bulletins

path Parameters
lang
required
string
Enum: "de" "fr" "it" "en"
Example: de

Desired language. If the desired language does not exists, a german bulletin will be returned

query Parameters
limit
integer >= 1
Default: 10
Example: limit=10

Number of bulletins to return

offset
integer >= 0
Default: 0
Example: offset=10

Number of bulletins to skip

Responses

Response samples

Content type
application/json
[
  • {
    }
]

List of bulletins as geojson

Returns a list of bulletins as geojson

path Parameters
lang
required
string
Enum: "de" "fr" "it" "en"
Example: de

Desired language. If the desired language does not exists, a german bulletin will be returned

query Parameters
limit
integer >= 1
Default: 10
Example: limit=10

Number of bulletins to return

offset
integer >= 0
Default: 0
Example: offset=10

Number of bulletins to skip

Responses

Response samples

Content type
application/json
[
  • {
    }
]