> For the complete documentation index, see [llms.txt](https://syticks.gitbook.io/merpi-by-syticks/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://syticks.gitbook.io/merpi-by-syticks/api-reference/cinema-ticketing-cinema-movies-available-days-purchase-etc/get-cinema-experience-details.md). # Get Cinema Experience Details This endpoint returns complete details about a single cinema experience (movie showings). Cinema experiences are recurring events that show at specific times over extended periods (days, weeks, or months). Use this endpoint when you need detailed information about a movie including: * Complete movie descriptions * Showtime schedules (with multi-location and per-day support) * Cinema location details * All movie posters/images * Showing frequency (daily, weekly, monthly) **Note:** This documentation covers cinema experiences only (`cinema: true`). For regular events (concerts, parties, festivals), see the [Get Regular Experience Details](https://sytickss-organization.gitbook.io/merpi-by-syticks/api-reference/experience-ticketing-events-parties-conference-comedy-and-more/get-experience-details) page. #### Endpoint ``` GET /api/v1/merpi/experience/v/{experience_id} ``` *** #### Path Parameters | Parameter | Type | Required | Description | | --------------- | ------------- | -------- | ------------------------------------------- | | `experience_id` | string (UUID) | Yes | Unique identifier of the cinema experience. | *** ### Response Format **Root Response Object** | Field | Type | Description | | --------- | ------- | ----------------------------------------------- | | `success` | boolean | Indicates whether the request was successful. | | `status` | integer | HTTP status code (200 for successful requests). | | `message` | string | Human-readable description of the response. | | `data` | object | The cinema experience details object. | **Data Object (Cinema Experience Details)** | Field | Type | Description | | ------------- | ------------- | -------------------------------------------------------------- | | `id` | string (UUID) | Unique identifier for the cinema experience. | | `title` | string | Movie title. | | `start_date` | string | Start date in format: "Day, DD Mon YYYY HH:MM:SS" | | `end_date` | string | End date in format: "Day, DD Mon YYYY HH:MM:SS" | | `description` | string | Complete movie description. | | `featured` | boolean | Whether the movie is featured. | | `cinema` | boolean | Always `true` for cinema experiences. | | `cinema_info` | object | Cinema-specific information including showtimes and locations. | | `address` | object | Address details (typically the headquarters address). | | `image` | array | Array of movie poster/image objects. | | `business` | object | Information about the cinema business. | | `category` | object | Category information (typically "Cinema"). | | `created_on` | string | Creation timestamp in custom format. | **Cinema Info Object** | Field | Type | Description | | ----------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `showing` | string | Frequency of movie showings: `"weekly"`, `"monthly"`, or `"daily"`. | | `shared_times` | boolean | `true` if showtimes are shared across all locations, `false` if each location has its own. | | `shared_tickets` | boolean | `true` if ticket types are shared across all locations, `false` if location-specific. | | `per_day_times` | boolean | `true` if the cinema has configured different showtimes per day. When `true`, `days_with_times` will be populated at either the top level or per location depending on `shared_times`. | | `specific_dates` | array of strings | Only present for `showing: "daily"` cinemas. Lists exact screening dates in `"YYYY-MM-DD"` format. Empty for weekly and monthly. | | `times` | array | Showtime objects. Always populated for backward compatibility. When `shared_times` is `false`, contains all times across all locations combined. | | `days_with_times` | array | Per-day showtime breakdown. Populated when `per_day_times` is `true` and `shared_times` is `true`. Empty array otherwise (see location object for per-location breakdown). | | `locations` | array | Array of cinema location objects. | **Location Object** **Found in `cinema_info.locations[]`** | Field | Type | Description | | ----------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | integer | Unique identifier for this location. **Use this as `cinema_location_id` when purchasing tickets.** | | `name` | string | Location name (e.g., "Filmhouse Cinemas Lekki", "Genesis Cinemas Port Harcourt (HQ)"). | | `street` | string | Street address. | | `town` | string | Town or locality. | | `city` | string | City. | | `country` | string | Country (typically "Nigeria"). | | `is_headquarters` | boolean | `true` if this is the main/headquarters location, `false` for branches. | | `times` | array | Showtime objects for this location. Populated when `shared_times` is `false`. When `true`, showtimes are in `cinema_info.times[]` instead. | | `days_with_times` | array | Per-day showtime breakdown for this location. Populated when `shared_times` is `false` and `per_day_times` is `true`. Empty array otherwise. | **Time Object** **Found in `cinema_info.times[]`, `location.times[]`, or inside `days_with_times[].times[]`** | Field | Type | Description | | ----------- | ------- | --------------------------------------------------------------------------------------- | | `id` | integer | Unique identifier for this showtime. **Use this as `time_id` when purchasing tickets.** | | `start` | string | Start time (e.g., `"9:00AM"`, `"2:30PM"`). | | `end` | string | End time (e.g., `"11:30AM"`, `"4:45PM"`). | | `cinema_id` | integer | Reference to the cinema this showtime belongs to. | **Address Object** | Field | Type | Description | | --------- | ------ | ----------------- | | `street` | string | Street address. | | `town` | string | Town or locality. | | `city` | string | City. | | `country` | string | Country. | **Image Object** | Field | Type | Description | | ------- | ------------ | ----------------------------------- | | `image` | string (URL) | Full URL to the movie poster/image. | **Business Object** | Field | Type | Description | | ------- | -------------------- | ---------------------------------------------------------- | | `id` | string (UUID) | Unique identifier for the cinema business. | | `name` | string | Cinema business name. | | `photo` | string (URL) or null | URL to business logo/photo. | | `slug` | string | URL-friendly identifier. | | `type` | string | Business type (typically `"entertainment"` or `"cinema"`). | **Category Object** | Field | Type | Description | | ------ | ------------- | ------------------------------------- | | `id` | string (UUID) | Category identifier. | | `slug` | string | Category slug (typically `"cinema"`). | | `name` | string | Category name (typically `"Cinema"`). | *** ### Example Responses **Weekly Cinema, Shared Times, No Per-Day Times** `per_day_times: false`. A single set of showtimes applies to all locations at all times. `days_with_times` is empty everywhere. ```json { "success": true, "status": 200, "message": "Experience Details", "data": { "id": "b343ccca-087f-493e-875d-78301112b0e7", "title": "A Tribe Called Judas", "start_date": "Wed, 28 Oct 2026 21:02:40", "end_date": "Wed, 28 Oct 2026 00:00:00", "description": "A gripping Nollywood thriller about loyalty and betrayal.", "featured": false, "cinema": true, "cinema_info": { "showing": "weekly", "shared_times": true, "shared_tickets": true, "per_day_times": false, "specific_dates": [], "days_with_times": [], "times": [ { "id": 36, "start": "7:45PM", "end": "9:30PM", "cinema_id": 20 } ], "locations": [ { "id": 2, "name": "Filmhouse Cinemas Lekki (HQ)", "street": "4 Admiralty Way", "town": "Lekki Phase 1", "city": "Lagos", "country": "Nigeria", "is_headquarters": true, "times": [ { "id": 36, "start": "7:45PM", "end": "9:30PM", "cinema_id": 20 } ], "days_with_times": [] } ] }, "address": { "street": "4 Admiralty Way", "town": "Lekki Phase 1", "city": "Lagos", "country": "Nigeria" }, "image": [ { "image": "https://syticks.com/storage/experiences/a-tribe-called-judas.jpg" } ], "business": { "id": "764c6a94-7bda-448e-a8af-35a5bb536d4", "name": "Filmhouse Cinemas", "photo": "https://syticks.com/storage/businesses/filmhouse.jpg", "slug": "filmhouse-cinemas", "type": "cinema" }, "category": { "id": "56195f78-a14b-4dc2-b1b8-c3aa62a23f70", "slug": "cinema", "name": "Cinema" }, "created_on": "Mon, 05 Jan 2026 20:36:58" } } ``` **Weekly Cinema, Shared Times, Per-Day Times Enabled** `per_day_times: true`, `shared_times: true`. `days_with_times` is at the top level in `cinema_info`. Each location's `days_with_times` is an empty array. `day` is an integer from 1 (Monday) to 7 (Sunday). ```json { "success": true, "status": 200, "message": "Experience Details", "data": { "id": "a7ff5bd3-4994-4404-9184-af90bdf86338", "title": "The Lagos Chronicles", "start_date": "Tue, 30 Jun 2026 20:53:00", "end_date": "Tue, 30 Jun 2026 00:00:00", "description": "An epic tale set across the streets of Lagos.", "featured": false, "cinema": true, "cinema_info": { "showing": "weekly", "shared_times": true, "shared_tickets": true, "per_day_times": true, "specific_dates": [], "days_with_times": [ { "day": 7, "day_name": "Sunday", "times": [ { "id": 62, "start": "10:15PM", "end": "11:05PM", "cinema_id": 24 } ] }, { "day": 6, "day_name": "Saturday", "times": [ { "id": 63, "start": "7:40PM", "end": "8:35PM", "cinema_id": 24 } ] } ], "times": [ { "id": 62, "start": "10:15PM", "end": "11:05PM", "cinema_id": 24 }, { "id": 63, "start": "7:40PM", "end": "8:35PM", "cinema_id": 24 } ], "locations": [ { "id": 2, "name": "Filmhouse Cinemas Lekki (HQ)", "street": "4 Admiralty Way", "town": "Lekki Phase 1", "city": "Lagos", "country": "Nigeria", "is_headquarters": true, "times": [ { "id": 62, "start": "10:15PM", "end": "11:05PM", "cinema_id": 24 }, { "id": 63, "start": "7:40PM", "end": "8:35PM", "cinema_id": 24 } ], "days_with_times": [] }, { "id": 4, "name": "Filmhouse Cinemas Abuja", "street": "Plot 1019 Herbert Macaulay Way", "town": "Central Business District", "city": "Abuja", "country": "Nigeria", "is_headquarters": false, "times": [ { "id": 62, "start": "10:15PM", "end": "11:05PM", "cinema_id": 24 }, { "id": 63, "start": "7:40PM", "end": "8:35PM", "cinema_id": 24 } ], "days_with_times": [] } ] }, "address": { "street": "4 Admiralty Way", "town": "Lekki Phase 1", "city": "Lagos", "country": "Nigeria" }, "image": [ { "image": "https://syticks.com/storage/experiences/the-lagos-chronicles.jpg" } ], "business": { "id": "764c6a94-7bda-448e-a8af-35a5bb536d4", "name": "Filmhouse Cinemas", "photo": "https://syticks.com/storage/businesses/filmhouse.jpg", "slug": "filmhouse-cinemas", "type": "cinema" }, "category": { "id": "56195f78-a14b-4dc2-b1b8-c3aa62a23f70", "slug": "cinema", "name": "Cinema" }, "created_on": "Mon, 01 Jun 2026 01:19:49" } } ``` **Monthly Cinema, Location-Specific Times, Per-Day Times Enabled** `per_day_times: true`, `shared_times: false`. `days_with_times` is inside each location. The top-level `cinema_info.days_with_times` is empty. Each `days_with_times` entry uses `"date"` as a string representing the day of the month (e.g., `"15"` means the 15th of every month). ```json { "success": true, "status": 200, "message": "Experience Details", "data": { "id": "a34c959b-ceab-4211-9670-a6709e74216e", "title": "Gangs of Makoko", "start_date": "Fri, 30 Oct 2026 20:54:40", "end_date": "Fri, 30 Oct 2026 00:00:00", "description": "A raw and riveting story from the waterfront.", "featured": false, "cinema": true, "cinema_info": { "showing": "monthly", "shared_times": false, "shared_tickets": false, "per_day_times": true, "specific_dates": [], "days_with_times": [], "times": [ { "id": 39, "start": "1:40PM", "end": "3:50PM", "cinema_id": 23 }, { "id": 40, "start": "2:40PM", "end": "4:40PM", "cinema_id": 23 } ], "locations": [ { "id": 2, "name": "Genesis Cinemas Lagos (HQ)", "street": "19 Adeniran Ogunsanya Street", "town": "Surulere", "city": "Lagos", "country": "Nigeria", "is_headquarters": true, "times": [ { "id": 39, "start": "1:40PM", "end": "3:50PM", "cinema_id": 23 } ], "days_with_times": [ { "date": "15", "times": [ { "id": 39, "start": "1:40PM", "end": "3:50PM", "cinema_id": 23 } ] } ] }, { "id": 4, "name": "Genesis Cinemas Port Harcourt", "street": "3 Azikiwe Road", "town": "Old GRA", "city": "Port Harcourt", "country": "Nigeria", "is_headquarters": false, "times": [ { "id": 40, "start": "2:40PM", "end": "4:40PM", "cinema_id": 23 } ], "days_with_times": [ { "date": "20", "times": [ { "id": 40, "start": "2:40PM", "end": "4:40PM", "cinema_id": 23 } ] } ] } ] }, "address": { "street": "19 Adeniran Ogunsanya Street", "town": "Surulere", "city": "Lagos", "country": "Nigeria" }, "image": [ { "image": "https://syticks.com/storage/experiences/gangs-of-makoko.jpg" } ], "business": { "id": "764c6a94-7bda-448e-a8af-35a5bb536d4", "name": "Genesis Cinemas", "photo": "https://syticks.com/storage/businesses/genesis.jpg", "slug": "genesis-cinemas", "type": "cinema" }, "category": { "id": "56195f78-a14b-4dc2-b1b8-c3aa62a23f70", "slug": "cinema", "name": "Cinema" }, "created_on": "Fri, 10 Apr 2026 12:37:32" } } ``` **Daily Cinema, Location-Specific Times, Per-Day Times Enabled** `showing: "daily"`, `shared_times: false`, `per_day_times: true`. `specific_dates` lists the exact calendar dates the movie screens. `days_with_times` is inside each location, with each entry using a full `"YYYY-MM-DD"` date. ```json { "success": true, "status": 200, "message": "Experience Details", "data": { "id": "63c48790-789a-4d94-a30f-ce816ec6dfd0", "title": "Breath of Life", "start_date": "Mon, 31 Aug 2026 17:11:10", "end_date": "Mon, 31 Aug 2026 00:00:00", "description": "A moving drama about resilience and hope.", "featured": false, "cinema": true, "cinema_info": { "showing": "daily", "shared_times": false, "shared_tickets": false, "per_day_times": true, "specific_dates": [ "2026-06-18", "2026-06-27" ], "days_with_times": [], "times": [ { "id": 57, "start": "5:20PM", "end": "7:09PM", "cinema_id": 25 }, { "id": 58, "start": "9:45PM", "end": "11:09PM", "cinema_id": 25 }, { "id": 59, "start": "4:20PM", "end": "8:40PM", "cinema_id": 25 }, { "id": 60, "start": "8:35PM", "end": "10:45PM", "cinema_id": 25 } ], "locations": [ { "id": 2, "name": "Silverbird Cinemas Victoria Island (HQ)", "street": "133 Ahmadu Bello Way", "town": "Victoria Island", "city": "Lagos", "country": "Nigeria", "is_headquarters": true, "times": [ { "id": 57, "start": "5:20PM", "end": "7:09PM", "cinema_id": 25 }, { "id": 58, "start": "9:45PM", "end": "11:09PM", "cinema_id": 25 } ], "days_with_times": [ { "date": "2026-06-18", "times": [ { "id": 57, "start": "5:20PM", "end": "7:09PM", "cinema_id": 25 } ] }, { "date": "2026-06-27", "times": [ { "id": 58, "start": "9:45PM", "end": "11:09PM", "cinema_id": 25 } ] } ] }, { "id": 4, "name": "Silverbird Cinemas Abuja", "street": "Aminu Kano Crescent", "town": "Wuse 2", "city": "Abuja", "country": "Nigeria", "is_headquarters": false, "times": [ { "id": 59, "start": "4:20PM", "end": "8:40PM", "cinema_id": 25 }, { "id": 60, "start": "8:35PM", "end": "10:45PM", "cinema_id": 25 } ], "days_with_times": [ { "date": "2026-06-18", "times": [ { "id": 59, "start": "4:20PM", "end": "8:40PM", "cinema_id": 25 } ] }, { "date": "2026-06-27", "times": [ { "id": 60, "start": "8:35PM", "end": "10:45PM", "cinema_id": 25 } ] } ] } ] }, "address": { "street": "133 Ahmadu Bello Way", "town": "Victoria Island", "city": "Lagos", "country": "Nigeria" }, "image": [ { "image": "https://syticks.com/storage/experiences/breath-of-life.jpg" } ], "business": { "id": "764c6a94-7bda-448e-a8af-35a5bb536d4", "name": "Silverbird Cinemas", "photo": "https://syticks.com/storage/businesses/silverbird.jpg", "slug": "silverbird-cinemas", "type": "cinema" }, "category": { "id": "56195f78-a14b-4dc2-b1b8-c3aa62a23f70", "slug": "cinema", "name": "Cinema" }, "created_on": "Tue, 02 Jun 2026 11:39:55" } } ``` *** ### Understanding Showtimes Structure **Shared Times vs. Location-Specific Times** When `shared_times: true`, all locations show the movie at the same times. Showtimes are in `cinema_info.times[]` and each location's `times[]` mirrors them. When `shared_times: false`, `cinema_info.times[]` contains all times across all locations combined (for backward compatibility). Each location's unique showtimes are in `location.times[]`. **Per-Day Times** When `per_day_times: true`, the `days_with_times` array groups showtimes by day or date. Where it appears depends on `shared_times`: * `shared_times: true`: `days_with_times` is at the top level in `cinema_info`. Each location's `days_with_times` is empty. * `shared_times: false`: `days_with_times` is inside each location. The top-level `cinema_info.days_with_times` is empty. The structure of each entry varies by schedule type: **Weekly** - uses `day` (integer 1-7, Monday to Sunday) and `day_name`: ```json { "day": 6, "day_name": "Saturday", "times": [...] } ``` **Monthly** - uses `"date"` as a string for the day of the month: ```json { "date": "15", "times": [...] } ``` **Daily** - uses `"date"` as a full `"YYYY-MM-DD"` calendar date: ```json { "date": "2026-06-18", "times": [...] } ``` Use the following table to determine the correct field to read based on the cinema configuration. | `shared_times` | `per_day_times` | Where to read showtimes | | -------------- | --------------- | -------------------------------------------- | | `true` | `false` | `cinema_info.times` | | `true` | `true` | `cinema_info.days_with_times` | | `false` | `false` | `location.times` for each location | | `false` | `true` | `location.days_with_times` for each location | **How to Extract Showtimes** ```javascript function getShowtimes(cinemaInfo, locationId = null) { const { shared_times, per_day_times, times, days_with_times, locations } = cinemaInfo; if (shared_times) { return { type: 'shared', showtimes: per_day_times ? days_with_times : times, applicableToAll: true }; } if (locationId) { const location = locations.find(loc => loc.id === locationId); return { type: 'location_specific', showtimes: per_day_times ? location?.days_with_times : location?.times, location: location?.name }; } return { type: 'location_specific', locationShowtimes: locations.map(loc => ({ location_id: loc.id, location_name: loc.name, city: loc.city, showtimes: per_day_times ? loc.days_with_times : loc.times })) }; } ``` *** ### Multi-Location Cinema Handling **Detecting Multi-Location Cinemas** ```javascript function isMultiLocation(movie) { return movie.cinema_info?.locations?.length > 1; } ``` **Displaying Showtimes Per Location** ```javascript async function loadMovieDetails(movieId) { const response = await fetch(`/api/v1/merpi/experience/v/${movieId}`); const data = await response.json(); if (data.success && data.data.cinema) { const movie = data.data; const { shared_times, per_day_times, locations } = movie.cinema_info; if (shared_times) { const showtimes = per_day_times ? movie.cinema_info.days_with_times : movie.cinema_info.times; displaySharedShowtimes(showtimes, locations); } else { locations.forEach(location => { const showtimes = per_day_times ? location.days_with_times : location.times; displayLocationShowtimes(location, showtimes); }); } } } ``` **Using Python** ```python import requests movie_id = 'a16956f3-0205-408c-a948-0b75a5ff304f' response = requests.get( f'https://api.syticks.com/api/v1/merpi/experience/v/{movie_id}', headers={'Accept': 'application/json'} ) data = response.json() if data['success'] and data['data']['cinema']: movie = data['data'] info = movie['cinema_info'] if info['shared_times']: showtimes = info['days_with_times'] if info['per_day_times'] else info['times'] print(f"Shared showtimes: {len(showtimes)}") else: for loc in info['locations']: showtimes = loc['days_with_times'] if info['per_day_times'] else loc['times'] print(f"{loc['name']}: {len(showtimes)} showtime entries") if info['showing'] == 'daily': print(f"Screening dates: {info['specific_dates']}") ``` *** ### Request Examples **Basic Request** ```http GET /api/v1/merpi/experience/v/a16956f3-0205-408c-a948-0b75a5ff304f HTTP/1.1 Host: api.syticks.com Accept: application/json ``` **Using cURL** ```bash curl -X GET "https://api.syticks.com/api/v1/merpi/experience/v/a16956f3-0205-408c-a948-0b75a5ff304f" \ -H "Accept: application/json" ``` *** ### Important Notes **Date Formats** * Dates are returned in human-readable format: `"Day, DD Mon YYYY HH:MM:SS"` * Showtimes use 12-hour format: `"9:00AM"`, `"2:30PM"`, `"11:45PM"` * Dates inside `days_with_times` for daily schedules use `"YYYY-MM-DD"` format * Dates inside `days_with_times` for monthly schedules are strings representing the day of the month (e.g., `"15"`) **Cinema Location ID** **When purchasing tickets for multi-location cinemas**, always include the `cinema_location_id` parameter to specify which location the customer selected. Use the `location.id` value from the response. Without it, the purchase defaults to headquarters, which may not be the customer's intended location. **Showtime Frequency** The `cinema_info.showing` field indicates screening frequency: * `"weekly"` - Movie shows on specific days each week * `"monthly"` - Movie shows on specific days each month * `"daily"` - Movie shows on specific calendar dates listed in `specific_dates` *** ### Next Steps After fetching cinema experience details: 1. **Display locations** - If multi-location, show a location selector to the customer 2. **Display showtimes** - Use `days_with_times` when `per_day_times` is `true`, otherwise use `times` 3. **Get tickets** - Call the Get Ticket Types endpoint with `cinema_location_id` for multi-location cinemas 4. **Create holds** - Reserve seats via POST /api/v1/merpi/validate before purchase 5. **Purchase** - Complete booking with `reservation_ids`, `cinema_location_id`, and `time_id` *** ### Related Endpoints * [**Get List of Experiences**](https://sytickss-organization.gitbook.io/merpi-by-syticks/api-reference/cinema-ticketing-cinema-movies-available-days-purchase-etc/get-list-of-cinema-movies) - Browse all cinema movies with `cinema=true` filter * [**Get Ticket Types**](https://sytickss-organization.gitbook.io/merpi-by-syticks/api-reference/cinema-ticketing-cinema-movies-available-days-purchase-etc/get-cinema-ticket-categories-and-pricing) - Fetch ticket types and pricing (include `cinema_location_id` for multi-location) * [**Hold/Reserve Cinema Tickets**](https://sytickss-organization.gitbook.io/merpi-by-syticks/api-reference/hold-reserve-ticket-inventory/hold-reserve-experience-inventory) - Create holds before purchasing * [**Buy Cinema Tickets**](https://sytickss-organization.gitbook.io/merpi-by-syticks/api-reference/cinema-ticketing-cinema-movies-available-days-purchase-etc/buy-cinema-experience-tickets) - Complete purchase with `reservation_ids` and `cinema_location_id` * [**Get Regular Experience Details**](https://sytickss-organization.gitbook.io/merpi-by-syticks/api-reference/experience-ticketing-events-parties-conference-comedy-and-more/get-experience-details) - For non-cinema events --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://syticks.gitbook.io/merpi-by-syticks/api-reference/cinema-ticketing-cinema-movies-available-days-purchase-etc/get-cinema-experience-details.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.