API Versioning

Our API uses URL-based versioning to ensure backward compatibility and provide a stable development experience. All API endpoints are prefixed with a version identifier.

Current Version

We are currently on v1 of our API. All endpoints should be accessed using the /v1 prefix.

Base URL

https://api.beltic.com/v1

Versioning Strategy

URL Versioning

We use URL path versioning where the version is included in the API endpoint path:

GET https://api.beltic.com/v1/endpoint
POST https://api.beltic.com/v1/endpoint

Backward Compatibility

• v1 is our current stable version and will remain active for an extended period
• We maintain backward compatibility within major versions
• Minor updates and new features are added to v1 without breaking existing functionality
• We do not frequently introduce new major versions, ensuring long-term stability
• Breaking changes will result in a new major version (e.g., v2), but this happens rarely

Version Lifecycle