Place Events

These apps are used to retrieve events that will display data on a city(destination) level given the meeting dates.

When is Troop calling my endpoint?

Troop will query your endpoint when a user clicks on the About tab of a destination, once a destination from your meeting has been analyzed. The options returned by your endpoint will be listed below the basic information of the destination. The start and end dates used in the request will be the same ones from your meeting.

Example for Sport Events

JSON Payload

The JSON payload must accept the following fields:

Field	Description	Required	Type	Example
dateFrom	The start date.	true	Date string	2023-11-29
dateTo	The end date.	true	Date string	2023-12-04
radius	The search radius.	true	Integer	25
countryName	The country name.	true	String	United States of America
cityName	The city name.	true	String	Los Angeles

Example:

{
    "dateFrom": "2024-02-29",
    "dateTo": "2024-03-10",
    "radius": 1000,
    "countryName": "United States of America",
    "cityName": "Los Angeles"
}

JSON Response

The response payload must be similar to the following:

{
    "result": {
        "statusCode": 200,
        "data": {
            "all": {
                "control": {
                    "page": 1,
                    "perpage": 10,
                    "totalpages": 2,
                    "totalrecords": 14,
                    "w": "5370",
                    "title": "",
                    "nearbycount": 0,
                    "datefrom": "29/02/2024",
                    "dateto": "10/03/2024"
                },
                "data": [
                    {
                        "id": "339985",
                        "caption": "Los Angeles Lakers vs Washington Wizards",
                        "home_team_caption": "Los Angeles Lakers",
                        "away_team_caption": "Washington Wizards",
                        "sport": "Basketball",
                        "tournament": "NBA (Basketball)",
                        "date": "2024-02-29",
                        "date_of_event": "Thu, 29 Feb 2024",
                        "venue": "Crypto.com Arena (Staples Center)",
                        "venue_img": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/5188/large.jpg?1427870555",
                        "venue_address": "1111 S. Figueroa Street \r<br>Los Angeles, CA 90015",
                        "venue_lat": "34.0431",
                        "venue_lon": "-118.267"
                    },
                    {
                        "id": "339994",
                        "caption": "Los Angeles Clippers vs Washington Wizards",
                        "home_team_caption": "Los Angeles Clippers",
                        "away_team_caption": "Washington Wizards",
                        "sport": "Basketball",
                        "tournament": "NBA (Basketball)",
                        "date": "2024-03-01",
                        "date_of_event": "Fri, 01 Mar 2024",
                        "venue": "Crypto.com Arena (Staples Center)",
                        "venue_img": "https://s3.amazonaws.com/media.ticketevolution.com/configurations/static_maps/18273/large.jpg?1424365321",
                        "venue_address": "1111 S. Figueroa Street \r<br>Los Angeles, CA 90015",
                        "venue_lat": "34.0431",
                        "venue_lon": "-118.267"
                    }
                ],
                "execution_time": 15.600891828536987
            }
        }
    }
}