18
4
2
EventZR uses URI-based API versioning. All endpoints include a version prefix (e.g., /v1/, /v2/). Semantic versioning governs SDK releases.
| Aspect | Strategy | Details |
|---|---|---|
| API Endpoints | URI versioning | /event/v1/events, /event/v2/events |
| SDK Packages | Semantic versioning | Major.Minor.Patch (e.g., 2.1.0) |
| Breaking changes | New major version | Old version supported 12+ months |
| Non-breaking changes | Same version | Additive fields, new optional params |
| Deprecation notice | Sunset header | Minimum 6-month notice period |
| Version negotiation | Accept-Version header | Optional override per request |
| Service | Current | Adoption | Daily Requests | Status |
|---|---|---|---|---|
| Events API | v2.1 | 87% | 245,000 | Current |
| Venues API | v1.8 | 92% | 189,000 | Current |
| Auth API | v2.5 | 95% | 520,000 | Current |
| Bookings API | v2.0 | 78% | 156,000 | Current |
| Ticketing API | v1.3 | 88% | 98,000 | Current |
| Search API | v2.4 | 91% | 340,000 | Current |
| Bookings API | v1.5 | 45% | 67,000 | Deprecated |
| Events API | v1.0 | 12% | 12,000 | Sunset Q2 |
// Default: Use URI version
GET /event/v2/events HTTP/1.1
Host: api.eventzr.com
Authorization: Bearer <token>
x-tenant-id: <tenant-id>
// Override: Accept-Version header (optional)
GET /event/events HTTP/1.1
Host: api.eventzr.com
Accept-Version: v2.1
Authorization: Bearer <token>
x-tenant-id: <tenant-id>
// Response includes version info
HTTP/1.1 200 OK
X-API-Version: v2.1
Sunset: Sat, 30 Jun 2026 00:00:00 GMT // Only if deprecated
Deprecation: true // Only if deprecated| SDK Package | Version | API Versions Supported | Node.js |
|---|---|---|---|
| @eventzr/event-client | v2.5.0 | Events API v2.0, v2.1 | >=18 |
| @eventzr/venue-client | v1.9.0 | Venues API v1.5-v1.8 | >=18 |
| @eventzr/auth-client | v2.5.2 | Auth API v2.0-v2.5 | >=18 |
| @eventzr/booking-client | v2.1.0 | Bookings API v2.0 | >=18 |
| @eventzr/search-client | v2.4.0 | Search API v2.0-v2.4 | >=18 |
| @eventzr/ticketing-client | v1.3.0 | Ticketing API v1.0-v1.3 | >=18 |
| Method | Endpoint | Description | Auth |
|---|---|---|---|
GET | /status/v1/api-versions | List all API versions and their status | None |
GET | /status/v1/api-versions/:service | Get version details for a specific service | None |
GET | /status/v1/deprecations | List all deprecated APIs with sunset dates | None |