Events

This entity describes an event. This entity stores a substantial amount of information that is vital for the operation of menta tech. It is crucial that you provide this information as described to ensure everything functions correctly.

Attributes

Field	Data Type	Example	Description	Required
title	String	"Drake in Concert"	Event title	Yes
description	String	“Don’t miss this unique show in Argentina. Drake will perform at the River Plate Stadium…”	Full description of the event	Yes
externalReferenceId	String	"340"	The identifier used by your platform to refer to this event. Must be unique.	Yes
show	Array[Show]		Array of shows that are part of the event. Each show includes details such as title, date, and ticket options.	Yes
location	Object		See table below.	Yes
configuration	Object		See table below.	No

Entity location

Field	Data Type	Example	Description	Required
city	String	"New York City"	Name of the city where the event takes place.	No
state	String	"New York"	State or province where the event takes place.	No
venueName	String	"Broadway Theatre"	Name of the venue where the event takes place.	No
address	String	"200 W 45th Street"	Address of the venue where the event takes place.	No
country	String	"United States"	Country where the event takes place.	No
timeZone	String	"America/New_York"	Time zone of the event location.	No
raw	String	"Broadway Theatre"	Unprocessed information related to the location.	No
map	Object	{ "thumbnail": "URL", "googleMapsUrl": "URL" }	Additional map information for the location.	No

Entity configuration

Field	Data Type	Example	Description	Required
policy	String	"OPTIONAL"	WillCall policy for the event. Can be "NONE", "OPTIONAL", or "MANDATORY".	No
instructions	String	"Present the pickup code at the theater box office."	Instructions for users on how to pick up their tickets using WillCall.	No
hoursBeforeShow	Integer	168	Specifies in hours how much before the event WillCall should be available. Typically, ticketing systems allow WillCall 2 weeks before the event.	No

In this table, almost all fields are primitive, except for show, which requires sending an array of the Show entity.

More about the Show entity

The Show entity allows an event to have more than one show. Read more about Show

Example of a Complete Event

Including the Show and TicketOption entities

{
    "title": "The Lion King",
    "description": "Over 60 million people from around the world have come to experience the excitement and discover the splendor of the incomparable musical, The Lion King.",
    "externalReferenceId": "the-lion-king-broadway",
    "shows": [
        {
            "title": "The Lion King in Broadway Theatre",
            "status": "LIVE",
            "images": [
                {
                    "url": "https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp",
                    "kind": "main"
                }
            ],
            "showId": "4726",
            "date": "2022-04-02T14:00:00.000-04:00",
            "ticketOptions": [
                {
                    "title": "Standard Seat",
                    "ticketId": "0001",
                    "description": "Good view and sound. Located 40 to 60 meters from the stage.",
                    "price": 5500,
                    "currency": "ARS"
                },
                {
                    "title": "Premium Seat",
                    "ticketId": "0002",
                    "description": "Located at the front of the theater, with an excellent view and premium sound.",
                    "price": 13800,
                    "currency": "ARS"
                }
            ]
        }
    ],
    "location": {
        "city": "New York City",
        "state": "New York",
        "venueName": "Broadway Theatre",
        "address": "200 W 45th Street",
        "country": "United States"
    }
}