Get Experience Details

Fetches the details of a single experience.

This endpoint returns complete details about a single regular experience (events like concerts, parties, festivals, shows, etc.). Regular experiences are one-time or limited-duration events with specific start and end dates.

Note: This documentation covers regular experiences only (cinema: false). For cinema experiences (movies), see the Get Cinema Experience Details page.

Retrieve a Single Regular Experience

get

Fetch detailed information about a specific regular experience using the experience ID. Regular experiences are one-time or limited-duration events with specific start and end dates.

IMPORTANT: Always validate that the end_date has NOT passed before allowing customers to purchase tickets.

Path parameters

experience_idstring · uuidRequired

Unique identifier for the experience (UUID format)

Example: 223f279b-28b2-4b72-8020-cfc2c02b95cb

Responses

200

Successfully retrieved 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 - 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": "223f279b-28b2-4b72-8020-cfc2c02b95cb",
    "title": "Easter In Sana Forex",
    "start_date": "Wed, 29 Jan 2025 04:41:00",
    "end_date": "Sun, 29 Jan 2023 04:41:00",
    "description": "Join us for an unforgettable Easter celebration featuring live music, food, drinks, and entertainment for the whole family.",
    "featured": false,
    "cinema": false,
    "address": {
      "street": "12 Queenstown MD",
      "town": "Ikony",
      "city": "Lagos",
      "country": "Nigeria"
    },
    "image": [
      {
        "image": "https://dev.syticks.com/storage/EventPhotos/IradtAGsCHfOV1m6ajFr2xOaXnp2qtn3Lbq8IanZ.jpg"
      }
    ],
    "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": "5d4ccb2c-09ff-43a4-b96e-a2a035b4226b",
      "slug": "parties",
      "name": "Parties"
    },
    "created_on": "Sat, 28 Jan 2023 15:42:11"
  }
}

Path Parameters

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

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	Experience details object.

Data Object (Experience Details)

Field	Type	Description
id	string (UUID)	Unique identifier for the experience.
title	string	Name/title of the experience.
start_date	string	Start date and time of the experience in readable format ("Day, DD Mon YYYY HH:MM:SS").
end_date	string	End date and time of the experience in readable format ("Day, DD Mon YYYY HH:MM:SS").
description	string	Complete detailed description of the experience. May contain HTML or plain text.
featured	boolean	Indicates if the experience is featured on the platform.
cinema	boolean	Will always be false for regular experiences.
address	object	Complete venue location details.
image	array	Array of image objects. All promotional images for the experience.
business	object	Information about the business/organizer hosting the experience.
category	object	Category classification of the experience.
created_on	string	Timestamp when the experience was created in readable format ("Day, DD Mon YYYY HH:MM:SS").

Address Object

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

Image Object

Field	Type	Description
image	string (URL)	Full HTTPS URL to the experience image.

Business Object

Field	Type	Description
id	string (UUID)	Unique identifier for the business.
name	string	Business/organizer name.
photo	string (URL) / null	URL to the business profile photo. May be null if no photo uploaded.
slug	string	URL-friendly identifier for the business.
type	string	Type of business (e.g., "entertainment").

Category Object

Field	Type	Description
id	string (UUID)	Unique identifier for the category.
slug	string	URL-friendly identifier for the category.
name	string	Display name of the category (e.g., "Parties", "Concerts", "Festivals").

Request Examples

Basic request

GET /api/v1/merpi/experience/v/223f279b-28b2-4b72-8020-cfc2c02b95cb HTTP/1.1
Host: api.syticks.com
Accept: application/json

Using cURL

curl -X GET "https://api.syticks.com/api/v1/merpi/experience/v/223f279b-28b2-4b72-8020-cfc2c02b95cb" \
  -H "Accept: application/json"

Using JavaScript (Fetch)

const experienceId = '223f279b-28b2-4b72-8020-cfc2c02b95cb';

fetch(`https://api.syticks.com/api/v1/merpi/experience/v/${experienceId}`, {
  method: 'GET',
  headers: {
    'Accept': 'application/json'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Using Python (Requests)

import requests

experience_id = '223f279b-28b2-4b72-8020-cfc2c02b95cb'
url = f'https://api.syticks.com/api/v1/merpi/experience/v/{experience_id}'

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

Validating Experience Availability

CRITICAL - Ticket Sales Validation

Always validate that the experience end_date has NOT passed before allowing customers to purchase tickets. Selling tickets for expired events results in poor customer experience and potential refund issues.

Implementation requirement:

• Compare current date/time with end_date

• If current time > end_date, the experience has ended

• Block ticket purchases and display "Event has ended" message

• Consider hiding or marking expired experiences in listings {% endhint %}

JavaScript Validation Example

function canPurchaseTickets(experience) {
  const endDate = new Date(experience.end_date);
  const now = new Date();
  
  if (now > endDate) {
    return {
      canPurchase: false,
      reason: 'This event has ended'
    };
  }
  
  return {
    canPurchase: true,
    reason: null
  };
}

// Usage
const experience = data.data;
const validation = canPurchaseTickets(experience);

if (!validation.canPurchase) {
  alert(validation.reason);
  disableBookingButton();
} else {
  enableBookingButton();
}

Python Validation Example

from datetime import datetime

def can_purchase_tickets(experience):
    # Parse the date string
    end_date_str = experience['end_date']
    end_date = datetime.strptime(end_date_str, "%a, %d %b %Y %H:%M:%S")
    now = datetime.now()
    
    if now > end_date:
        return {
            'can_purchase': False,
            'reason': 'This event has ended'
        }
    
    return {
        'can_purchase': True,
        'reason': None
    }

# Usage
experience = data['data']
validation = can_purchase_tickets(experience)

if not validation['can_purchase']:
    print(f"Error: {validation['reason']}")
else:
    # Proceed with ticket purchase
    pass

Complete Validation with Start Date

function getExperienceStatus(experience) {
  const now = new Date();
  const startDate = new Date(experience.start_date);
  const endDate = new Date(experience.end_date);
  
  if (now < startDate) {
    return {
      status: 'upcoming',
      canPurchase: true,
      message: 'Tickets available for upcoming event'
    };
  }
  
  if (now >= startDate && now <= endDate) {
    return {
      status: 'ongoing',
      canPurchase: true,
      message: 'Event is currently happening - tickets may still be available'
    };
  }
  
  if (now > endDate) {
    return {
      status: 'expired',
      canPurchase: false,
      message: 'This event has ended'
    };
  }
}

Understanding Date Formats

This endpoint returns dates in a human-readable format rather than ISO 8601:

Format: "Day, DD Mon YYYY HH:MM:SS"

Examples:

• "Wed, 29 Jan 2025 04:41:00"

• "Sat, 15 Dec 2024 18:30:00"

Parsing Dates in Your Application

JavaScript

const dateString = "Wed, 29 Jan 2025 04:41:00";
const date = new Date(dateString);
console.log(date.toISOString()); // Converts to ISO format

Python

from datetime import datetime

date_string = "Wed, 29 Jan 2025 04:41:00"
date_obj = datetime.strptime(date_string, "%a, %d %b %Y %H:%M:%S")
print(date_obj.isoformat())  # Converts to ISO format

Common Use Cases

Display Event Details Page

async function loadEventDetails(experienceId) {
  const response = await fetch(`/api/v1/merpi/experience/v/${experienceId}`);
  const data = await response.json();
  
  if (data.success) {
    const experience = data.data;
    
    // Validate if event is still active
    const status = getExperienceStatus(experience);
    
    // Display title
    document.getElementById('title').textContent = experience.title;
    
    // Display dates
    document.getElementById('start').textContent = experience.start_date;
    document.getElementById('end').textContent = experience.end_date;
    
    // Display description
    document.getElementById('description').innerHTML = experience.description;
    
    // Display venue
    const address = experience.address;
    document.getElementById('venue').textContent = 
      `${address.street}, ${address.town}, ${address.city}, ${address.country}`;
    
    // Display images
    experience.image.forEach(img => {
      const imgElement = document.createElement('img');
      imgElement.src = img.image;
      document.getElementById('gallery').appendChild(imgElement);
    });
    
    // Show/hide booking button based on status
    if (!status.canPurchase) {
      document.getElementById('bookButton').disabled = true;
      document.getElementById('statusMessage').textContent = status.message;
    }
  }
}

Filtering Out Expired Events

async function getActiveExperiences() {
  const response = await fetch('/api/v1/merpi/experience');
  const data = await response.json();
  
  if (data.success) {
    // Filter out experiences that have ended
    const activeExperiences = data.data.experiences.filter(exp => {
      const endDate = new Date(exp.end_date);
      return new Date() <= endDate;
    });
    
    return activeExperiences;
  }
}

Key Differences from Cinema Experiences

Regular experiences differ from cinema experiences in the following ways:

Feature	Regular Experience	Cinema Experience
cinema field	Always false	Always true
cinema_info object	Not present	Present with showing and times
Duration	Fixed start and end dates	Recurring showtimes
Ticket types	Event-based	Showtime-based
Booking flow	Book for entire event period	Select specific showtime

Important: If you receive a response where cinema: true, you should handle it differently as it contains additional cinema_info data with showtimes. Refer to the Get Cinema Experience Details documentation for proper handling.

Next Steps

After fetching experience details, you can:

1. Validate availability - Check if end_date has passed before allowing purchases

2. Get ticket types and pricing - Use the tickets endpoint with the experience_id

3. Book tickets - Use the booking endpoint to reserve tickets (only if event hasn't ended)

4. Share experience - Use the slug from business object to create shareable links

5. Get directions - Use the address object to integrate with maps services

Related Endpoints

• Get List of Experiences - Browse all experiences with filtering

• Get Ticket Types - Fetch available ticket types for this experience

• Create Booking - Book tickets for this experience

• Get Cinema Experience Details - For cinema-specific experiences