Release notes for Sveriges Radio’s API for Important Public Announcements / VMA
This list is manually curated. Minor internal fixes not affecting API behavior are not included.
Breaking changes always result in a new major version of the API.
Version history
Version 3 (active) | Version 2 (maintenance)
v3.0.1
(2025-11-06)
latest
- Fix: Description field now preserves line breaks (consistent with v2 behavior).
- The beta version for v3 is now discontinued.
-
The subscribe endpoint has been sunset after identifying reliability limitations in production. It now returns HTTP 503 and is no longer documented. Clients are advised to continue using the regular API polling workflow as previously recommended.
v3.0.0 (2025-04-29)
Version 3 of the API is now officially released and is the recommended version for all integrations.
Version 3 release highlights
- Version 3 of the API is now out of beta and recommended for production use.
- Version 3.0-beta is deprecated and may be removed soon.
Version 2 Deprecation
- Version 2 remains supported for existing users.
- However, v3 is now the recommended version with ongoing updates and improvements.
- Deprecation warnings are included in response headers for v2 requests.
Response Headers
X-API-Version – version of the API used in the request.X-API-Latest-Version – latest stable API version.X-API-Beta-Version – latest available beta version (if any).X-API-Warning – warning for deprecated versions.Link – includes rel="latest-version" and rel="beta-version" links.
These headers make it easier to track API versions and determine whether you are using a stable or deprecated version.
Updates of Active Alerts
msgType=Update can now be used for updates to active alerts, combined with references.-
In v2 the
msgType remains Alert, but you can detect updates via the references field, which now applies to both Cancel and Update messages. Otherwise this is just like a new alert.
- If you do not want to explicitly handle updates in another way than new alerts, you do not need to differentiate on the msgType.
Fixed bug with subscribe endpoint
- The
/subscribe endpoint now works as intended.
v3.0-beta (2025-02-10)
Introduced v3.0-beta as a separate version, including improved version handling and structured data changes for future compatibility.
New API Version & Version Handling
- Introduced v3.0-beta with improved versioning and long-term support planning.
Experimental SSE Subscription for Real-Time Updates
- New
/subscribe endpoint using Server-Sent Events (SSE) for live updates.
- Messages are now structured JSON objects with timestamps for better tracking.
Atom & RSS Feed Changes
- New
/alerts/feed.{format} endpoint replaces older feed URLs.
- Improved validation of
format and geocode parameters.
Updated Swagger Documentation
- Schema updates and clearer descriptions for new endpoints and messages.
Accept Header Support
- API now correctly processes
Accept headers for proper content negotiation.
Model Schema & Enum Updates
- New enums for better data consistency.
- Nullable fields are now correctly represented.
Version 2 remains available for existing users and is maintained only for critical or backward-compatible fixes.
It is considered deprecated for new integrations.
v2.5.0
(2024-09-20)
maintenance
API
- Added feature flag
?useExercise=true for exercise alerts.
- Exercise alerts now include a new
Note field with exercise info.
Test API
- The
/testapi/v2/examples/data endpoint now includes an example of an exercise alert.
v2.4.0
(2024-08-21)
maintenance
API
- Fixed: times now presented in local time.
- Added delayed English translation for test alerts.
- Changed API version in Swagger to correct version: V2.
- Redirected /api/v2/ and /testapi/v2/ to return Swagger.
Other changes
- Improved Swagger and examples.
- Base URL now returns Swagger.
- Added release notes page.