Changelog
Changelog 2025-11-28
New Features
Cinema Showtimes Import History
Added endpoints to track and monitor showtimes import operations for cinemas. This allows cinema operators and admins to view the history and status of automated showtime imports from various ticket systems.
Endpoints
GET /cinema-showtimes-imports- List all showtimes import records with filtering and paginationGET /cinema-showtimes-imports/{cinemaShowtimesImportId}- Get details of a specific import record
Query Parameters (List endpoint)
| Parameter | Type | Description |
|---|---|---|
cinemaIds[] | integer[] | Filter by cinema IDs |
startDatetime | datetime | Filter imports starting from this datetime |
endDatetime | datetime | Filter imports ending before this datetime |
statuses[] | string[] | Filter by status (queued, in_progress, finished, failed, partially_failed) |
ticketSystems[] | string[] | Filter by ticket system (e.g., cinetixx, kinoheld) |
initiator | integer | Filter by initiator user ID |
Response Schema
Code
Key Features
- Status tracking - Monitor import progress with statuses:
queued,in_progress,finished,failed,partially_failed - Success/failure metrics - Track
successCount,failureCount, andtotalCountfor each import - Multi-system support - See which ticket systems were involved in each import
- Initiator tracking - Identify who triggered each import (user ID and username)
- HAL+JSON format - All endpoints return properly formatted HAL+JSON responses
Authorization
- Admin users can view all cinema showtimes imports
- Cinema employees can view imports for cinemas they have access to
Last modified on