Versioning

Payless Power employs URL path versioning with distinct endpoints for each major API version (e.g., /v1/, /v2/). Breaking changes trigger new major versions while maintaining previous versions for backwards compatibility.

Version types:

  • Major releases: Include breaking changes requiring code updates

  • Revision releases: Contain only backwards-compatible changes

Before deprecating any major version, PLP provides:

  • Advance notification

  • Clear deprecation timeline

  • Migration documentation

Best practice: Test new API versions in a QA environment before upgrading production systems. Full version details are available in our API changelog.

Example endpoints:

https://api.paylesspower.com/v1/customers
https://api.paylesspower.com/v2/customers