Last updated

API Versioning

The Bermuda Commercial Bank RESTful Open Banking API implements explicit versioning to ensure long-term stability and backward compatibility as the API evolves.

🔢 Current Version

The current and default version is:

v1

All API requests must be made using a versioned base URL. Example:

https://api.bcb.bm/v1/...

📌 Why Versioning Matters

Versioning allows us to:

  • Introduce new features without breaking existing integrations
  • Maintain predictable and reliable behavior for all clients
  • Provide a clear upgrade path as the API grows

🛠️ Developer Guidance

  • Always include the version prefix (/v1/) in your API requests.
  • Check for version announcements or updates in our API changelog or developer portal.
  • If a future version is released, you’ll be able to adopt it incrementally without affecting current usage.

This versioning strategy ensures your integration remains stable even as new capabilities are introduced.