Public Transit API Developer's Guide Alert
Alert contains all available information about an individual transit alert or an announcement.
Table 1. Alert Type Attributes Attribute Always Included Type Description id Yes, in responses to transit alert requests String Identifier for the alert. The
id is a unique value.
operator Yes, in responses to transit alert requests String Name of the operator of the public transit line. origin Yes, in responses to transit alert requests String Source of the alert. Available values are:
API- received from API
RSS- received from RSS
WEB- obtained from WEB
TWITTER- received from Twitter
INVITRO - alert issued internally
sec_ids Yes IDREFS Whitespace-separated list of section ids of a connection relevant to the given Alert. url - anyUrl URL which can be used be end-users to access the original alert. For example, for Twitter it would be an URL of the tweet. severity - String The severity value The following values are possible:
DISRUPT - The disruption exists but the severity is unknown
INFO - No disruption, just information
LOW - Low severity disruption
MEDIUM - Medium severity disruption
HIGH - High severity disruption
valid_from - DateTime Time from which the alert is valid, UTC timestamp in ISO 8601 (for example, 2017-12-25T01:23:45) format. valid_till - DateTime Time until which the alert is valid, UTC timestamp in ISO 8601 (for example, 2017-12-25T01:23:45) format.
Table 2. AlertType Elements Element Always Included Type Description Info Yes String Contains information about the public transit line or lines, such as expected closures or special requirements. Transports - Transports List of transports affected by the alert. Link - Link Link to a web resource with additional information.
link nodes do not contain any text if inside an
Branding - Branding Some alert sources (like Twitter) have branding requirement and clients must comply to these, for example by showing branding info to user. Note:
The Alerts are sourced from transit agencies' API feeds and/or Twitter accounts (where available). If the alerts' origin is from Twitter, you are required to follow Twitter's general principles for presenting alerts correctly. We do not provide any data for Twitter's logos and links for Twitter's actions. The full guidance on the display requirements can be found on
Twitter Display Requirements