Get Cinema Experience Details

Returns the details about a cinema experience/event like the days in the week the movie shows at the cinema, the times in the day when the movie shows(11:30pm - 1:45pm, 2:20pm - 4:50pm), etc.

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

• All movie posters/images

• Showing frequency (daily, weekly, etc.)

Note: This documentation covers cinema experiences only (cinema: true). For regular events (concerts, parties, festivals), see the Get Regular Experience Details page.

Retrieve a Single Cinema Experience

get

Fetch detailed information about a specific cinema experience using the experience ID. Cinema experiences are recurring movie showings with specific showtimes.

IMPORTANT: The response includes cinema_info object with showtime details. Each showtime has a unique id that must be used when booking tickets.

Path parameters

experience_idstring · uuidRequired

Unique identifier for the cinema experience (UUID format)

Example: 9b0c2340-8274-4e9b-b7b8-a652dbb652eb

Responses

200

Successfully retrieved cinema experience details

application/json

successbooleanOptional

Indicates whether the request was successful.

statusintegerOptional

HTTP status code (200 for success).

messagestringOptional

Human-readable description of the response.

400

Bad Request - Invalid experience ID format

application/json

404

Not Found - Cinema experience doesn't exist

application/json

500

Internal Server Error

application/json

get

/api/v1/merpi/experience/v/{experience_id}

HTTPcURLJavaScriptPython

GET /api/v1/merpi/experience/v/{experience_id} HTTP/1.1
Accept: */*

{
  "success": true,
  "status": 200,
  "message": "Detail of Experience",
  "data": {
    "id": "9b0c2340-8274-4e9b-b7b8-a652dbb652eb",
    "title": "Batman: The Yahoo Junction Menace 4",
    "start_date": "Tue, 16 Jun 2026 18:00:52",
    "end_date": "Tue, 01 Dec 2026 12:30:00",
    "description": "Gotham City faces a new threat as the enigmatic villain known as \"The Yahoo Junction\" wreaks havoc on the city's technological infrastructure.",
    "featured": false,
    "cinema": true,
    "cinema_info": {
      "showing": "weekly",
      "times": [
        {
          "id": 11,
          "start": "9:00AM",
          "end": "10:30AM",
          "cinema_id": 6
        },
        {
          "id": 12,
          "start": "2:00PM",
          "end": "5:30PM",
          "cinema_id": 6
        }
      ]
    },
    "address": {
      "street": "24 Regina Coeli Street",
      "town": "Amaku",
      "city": "Awka",
      "country": "Nigeria"
    },
    "image": [
      {
        "image": "https://dev.syticks.com/storage/EventPhotos/assets/images/logo/logo.png"
      }
    ],
    "business": {
      "id": "764c6a94-7bda-448e-a8af-35a5bb536d4",
      "name": "Party Hard Entertainment",
      "photo": "https://dev.syticks.com/storage/profilePhotos/PXpF7oIUjV1waH0rLUXFU4ssWg4NYzq1vT6GqHn7.jpg",
      "slug": "party-hard-entertainment",
      "type": "entertainment"
    },
    "category": {
      "id": "56195f78-a14b-4dc2-b1b8-c3aa62a23f70",
      "slug": "cinema",
      "name": "Cinema"
    },
    "created_on": "Tue, 27 Feb 2024 18:37:16"
  }
}

Path Parameters

Parameter	Type	Required	Description
experience_id	string (UUID)	Yes	Unique identifier for the cinema experience. Obtained from the list experiences endpoint with cinema=true filter.

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	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	Date when the movie started showing in readable format ("Day, DD Mon YYYY HH:MM:SS").
end_date	string	Planned end date for the movie showing in readable format. May be extended if movie performs well.
description	string	Complete movie description, plot summary, or synopsis. May contain HTML or plain text.
featured	boolean	Indicates if the movie is featured on the platform (e.g., blockbuster, new release).
cinema	boolean	Will always be true for cinema experiences.
cinema_info	object	Cinema-specific information including showing frequency and showtimes.
address	object	Cinema venue location details.
image	array	Array of image objects. Movie posters and promotional images.
business	object	Information about the cinema/business hosting the movie.
category	object	Category classification (typically "Cinema").
created_on	string	Timestamp when the movie was added to the platform in readable format.

Cinema Info Object

Only present for cinema experiences (cinema: true)

Field	Type	Description
showing	string	Frequency of movie showings. Common values: "weekly", "monthly"
times	array	Array of showtime objects. All available screening times for this movie.

Showtime Object

Each object in the times array represents a specific screening time:

Field	Type	Description
id	integer	Unique identifier for this showtime. Use this when booking tickets for a specific screening.
start	string	Showtime start time in 12-hour format (e.g., "9:00AM", "2:30PM").
end	string	Showtime end time in 12-hour format (e.g., "10:30AM", "4:00PM").
cinema_id	integer	Internal cinema identifier associated with this showtime.

Address Object

Field	Type	Description
street	string	Street address of the cinema venue.
town	string	Town or locality.
city	string	City where the cinema is located.
country	string	Country name (typically "Nigeria").

Image Object

Field	Type	Description
image	string (URL)	Full HTTPS URL to the movie poster or promotional image.

Business Object

Field	Type	Description
id	string (UUID)	Unique identifier for the cinema business.
name	string	Cinema business name (e.g., "Silverbird Cinemas", "Genesis Deluxe").
photo	string (URL) / null	URL to the cinema logo/photo. May be null if no photo uploaded.
slug	string	URL-friendly identifier for the cinema.
type	string	Type of business. Typically "entertainment".

Category Object

Field	Type	Description
id	string (UUID)	Unique identifier for the category.
slug	string	URL-friendly identifier. Typically "cinema" for movies.
name	string	Display name of the category. Typically "Cinema" for movies.

Request Examples

Basic request

GET /api/v1/merpi/experience/v/a16956f3-0205-408c-a948-0b75a5ff304f HTTP/1.1
Host: api.syticks.com
Accept: application/json

Using cURL

curl -X GET "https://api.syticks.com/api/v1/merpi/experience/v/a16956f3-0205-408c-a948-0b75a5ff304f" \
  -H "Accept: application/json"

Using JavaScript (Fetch)

const movieId = 'a16956f3-0205-408c-a948-0b75a5ff304f';

fetch(`https://api.syticks.com/api/v1/merpi/experience/v/${movieId}`, {
  method: 'GET',
  headers: {
    'Accept': 'application/json'
  }
})
  .then(response => response.json())
  .then(data => {
    if (data.success && data.data.cinema) {
      console.log('Movie:', data.data.title);
      console.log('Showtimes:', data.data.cinema_info.times);
    }
  })
  .catch(error => console.error('Error:', error));

Using Python (Requests)

import requests

movie_id = 'a16956f3-0205-408c-a948-0b75a5ff304f'
url = f'https://api.syticks.com/api/v1/merpi/experience/v/{movie_id}'

response = requests.get(url, headers={'Accept': 'application/json'})
data = response.json()

if data['success'] and data['data']['cinema']:
    print(f"Movie: {data['data']['title']}")
    print(f"Showtimes: {len(data['data']['cinema_info']['times'])} available")

Understanding Showtimes

Showtime Frequency

The cinema_info.showing field indicates how often the movie screens:

Value	Meaning	Example
"weekly"	Shows on specific days each week	Thursday-Sunday showings
"monthly"	Limited showings per month	Special screenings, indie films

Showtime Objects

Each showtime in the times array represents a unique screening. The id field is crucial for ticket booking:

// Example: Display showtimes
const showtimes = data.data.cinema_info.times;

showtimes.forEach(showtime => {
  console.log(`Showtime ID: ${showtime.id}`);
  console.log(`Time: ${showtime.start} - ${showtime.end}`);
  console.log(`Duration: ${calculateDuration(showtime.start, showtime.end)}`);
});

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"

Common Use Cases

Display Movie Details with Showtimes

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;
    
    // Display movie info
    document.getElementById('title').textContent = movie.title;
    document.getElementById('description').textContent = movie.description;
    document.getElementById('poster').src = movie.image[0].image;
    
    // Display cinema location
    const address = movie.address;
    document.getElementById('cinema').textContent = 
      `${movie.business.name} - ${address.city}`;
    
    // Display showtimes
    const showtimesHTML = movie.cinema_info.times.map(time => `
      <div class="showtime" data-id="${time.id}">
        <span>${time.start} - ${time.end}</span>
        <button onclick="bookTicket(${time.id})">Book Now</button>
      </div>
    `).join('');
    
    document.getElementById('showtimes').innerHTML = showtimesHTML;
  }
}

Filter Showtimes by Time of Day

function categorizeShowtimes(times) {
  const morning = [];
  const afternoon = [];
  const evening = [];
  
  times.forEach(time => {
    const hour = parseInt(time.start.split(':')[0]);
    const isPM = time.start.includes('PM');
    
    const hour24 = isPM && hour !== 12 ? hour + 12 : hour;
    
    if (hour24 < 12) {
      morning.push(time);
    } else if (hour24 < 17) {
      afternoon.push(time);
    } else {
      evening.push(time);
    }
  });
  
  return { morning, afternoon, evening };
}

Build Showtime Selector for Booking

function createShowtimeSelector(movie) {
  const showing = movie.cinema_info.showing;
  const times = movie.cinema_info.times;
  
  return {
    movieId: movie.id,
    title: movie.title,
    frequency: showing,
    availableSlots: times.map(t => ({
      id: t.id,
      timeRange: `${t.start} - ${t.end}`,
      cinemaId: t.cinema_id
    }))
  };
}

Check if Movie is Currently Showing

function isCurrentlyShowing(movie) {
  const now = new Date();
  const endDate = new Date(movie.end_date);
  
  return now <= endDate;
}

Key Differences from Regular Experiences

Cinema experiences have unique characteristics compared to regular events:

Feature	Cinema Experience	Regular Experience
cinema field	Always true	Always false
cinema_info object	Present with showing and times	Not present
Duration	Recurring over weeks/months	Fixed start and end dates
Ticket booking	Select specific showtime (using times[].id)	Book for the event date
Scheduling	Multiple showtimes per day/week	Single event period

Critical: When booking tickets for cinema experiences, you MUST specify the showtime_id from the cinema_info.times array. Each showtime is a separate screening and has limited seats.

Handling Cinema Info

Validating Cinema Response

Always check if cinema_info exists before accessing showtimes:

function getShowtimes(experience) {
  if (!experience.cinema || !experience.cinema_info) {
    throw new Error('Not a cinema experience');
  }
  
  if (!experience.cinema_info.times || experience.cinema_info.times.length === 0) {
    throw new Error('No showtimes available');
  }
  
  return experience.cinema_info.times;
}

Grouping Showtimes

For better UX, group showtimes by time of day or cinema location:

function groupByTimeOfDay(times) {
  return {
    morning: times.filter(t => {
      const hour = parseInt(t.start);
      return hour >= 6 && hour < 12;
    }),
    afternoon: times.filter(t => {
      const hour = parseInt(t.start);
      return hour >= 12 && hour < 17;
    }),
    evening: times.filter(t => {
      const hour = parseInt(t.start);
      return hour >= 17 || hour < 6;
    })
  };
}

Next Steps

After fetching cinema experience details, you can:

1. Display showtimes: Show all available screening times to users

2. Book tickets: Use the times[].id when creating a booking for a specific showtime

3. Check seat availability: Query seat availability for specific showtimes

4. Get cinema info: Use business data to show cinema location and details

5. Set reminders: Allow users to set reminders for showtimes

Related Endpoints

• Get List of Experiences - Browse all cinema movies with cinema=true filter

• Get Ticket Types - Fetch ticket types and pricing for specific showtimes

• Create Booking - Book tickets for a specific showtime

• Get Regular Experience Details - For non-cinema events