Skip to main content

API Changelog

Track API updates, new features, and breaking changes.

Versioning Policy​

GoRoute uses semantic versioning for API changes:

  • Major versions (v1 → v2): Breaking changes, announced 6+ months in advance
  • Minor versions: New features, backward compatible
  • Patch versions: Bug fixes, no API changes

The current API version is v1.

2024​

v1.8.0 — 2024-02-01​

New Features

  • ✨ Batch validation endpoint — Validate multiple documents in one call 
    POST /api/v1/batch/validate
  • ✨ Singapore InvoiceNow support — Full support for scheme 0195 (UEN)
  • ✨ Attachment preview — Get thumbnail previews of PDF attachments

Improvements

  • 📈 Improved SMP lookup performance (50% faster)
  • 📈 Better error messages for XRechnung validation
  • 📈 Added retry_after header on rate limit responses

Bug Fixes

  • 🐛 Fixed currency rounding for JPY invoices
  • 🐛 Fixed webhook retry timing calculation

v1.7.0 — 2024-01-15​

New Features

  • ✨ Partner verification API — Verify trading partner capabilities 
    GET /api/v1/participants/{id}/verify
  • ✨ Webhook signature v2 — More secure HMAC-SHA256 signatures
  • ✨ Transaction export — Export transaction history as CSV

Improvements

  • 📈 Added France Factur-X format support
  • 📈 Improved Italian SDI integration reliability
  • 📈 Extended transaction history retention to 7 years

Deprecations

  • ⚠️ X-Webhook-Signature-V1 header deprecated, use X-Webhook-Signature

v1.6.0 — 2024-01-01​

New Features

  • ✨ XRechnung 3.0 support — Latest German CIUS version
  • ✨ Async batch sending — Non-blocking batch operations 
    POST /api/v1/batch?async=true
  • ✨ Document search — Search received documents by metadata

Improvements

  • 📈 Updated Peppol BIS to 2024 release
  • 📈 Added Belgium scheme 0208 validation
  • 📈 Reduced validation latency by 30%

2023​

v1.5.0 — 2023-10-01​

New Features

  • ✨ Invoice Response (MLR) — Send and receive invoice responses
  • ✨ Participant migration API — Bulk migrate from other Access Points
  • ✨ Rate limit headers — X-RateLimit-Remaining, X-RateLimit-Reset

Improvements

  • 📈 Added Norwegian EHF 3.0 support
  • 📈 Improved webhook delivery reliability

Breaking Changes

  • ⚠️ None

v1.4.0 — 2023-07-01​

New Features

  • ✨ Credit Note API — Dedicated endpoint for credit notes
  • ✨ Attachment support — Embed PDF attachments in invoices
  • ✨ Webhook filtering — Subscribe to specific event types

Improvements

  • 📈 Added Netherlands scheme 0106 (KVK) validation
  • 📈 Better handling of large documents (up to 100MB)

v1.3.0 — 2023-04-01​

New Features

  • ✨ Sandbox environment — Test without affecting production
  • ✨ Participant lookup cache — Cached SMP responses
  • ✨ Transaction tracking — Real-time delivery status

Improvements

  • 📈 Reduced send latency by 40%
  • 📈 Added support for 15 new identifier schemes

v1.2.0 — 2023-01-15​

New Features

  • ✨ Webhooks — Real-time event notifications
  • ✨ Bulk registration — Register multiple participants at once
  • ✨ API key scopes — Granular permissions

Improvements

  • 📈 Enhanced validation error messages
  • 📈 Added idempotency key support

2022​

v1.1.0 — 2022-10-01​

New Features

  • ✨ Validation API — Pre-flight document validation
  • ✨ Document types — Order, Order Response support
  • ✨ Multi-organization — Single API key, multiple organizations

Improvements

  • 📈 Improved uptime to 99.99%
  • 📈 Added detailed API documentation

v1.0.0 — 2022-06-01​

Initial Release 🚀

  • Invoice and Credit Note sending via Peppol
  • Participant registration on Peppol SMP
  • Basic webhook notifications
  • REST API with JSON responses
  • Python and JavaScript SDKs

Upcoming Changes​

v1.9.0 — Planned Q2 2024​

  • 🔮 E-Ordering — Full ordering workflow support
  • 🔮 AI validation — Machine learning for invoice validation
  • 🔮 GraphQL API — Alternative to REST for complex queries
  • 🔮 Real-time streaming — WebSocket for live updates

v2.0.0 — Planned Q4 2024​

Major version upgrade with:

  • Simplified API structure
  • Enhanced security model
  • Expanded country support

Migration Path: Documentation and tools will be provided 6 months before v2 release.

Deprecation Policy​

TimelineAction
AnnouncementDeprecation notice in changelog and API response headers
+3 monthsWarning emails to affected users
+6 monthsFeature removed from documentation
+12 monthsFeature disabled (major versions only)

Subscribe to Updates​

Stay informed about API changes:

Next Steps​