Base URL & Versioning

API endpoint structure and versioning information

The Bags API uses a consistent base URL structure for all endpoints:

• Base URL: https://public-api-v2.bags.fm/api/v1/
• Current version: v1
• Health check: GET /ping returns {message: "pong"}

All endpoints are prefixed with the base URL. Future API versions will be released with updated version numbers in the path.

Health Check

Test API connectivity:

cURL

curl https://public-api-v2.bags.fm/ping

Response:

{
  "message": "pong"
}

Version History

Version	Release Date	Status	Breaking Changes
v1	2025-08-02	Current	N/A (Initial release)

Future API versions will maintain backward compatibility where possible. Breaking changes will be clearly documented and communicated in advance.