{ "openapi": "3.1.0", "info": { "title": "Wander - API partners", "description": "This API, developed by Wander, allows partner applications to access Wander's event data. Authentication, provided by the Wander team, is required to use this API. If you are interested in utilizing this API, please contact us at: support-api@wander-app.fr.\n\n**Last update: 2025-03-03**", "termsOfService": "https://wander-app.fr/api/terms-of-use", "contact": { "email": "support-api@wander-app.fr" }, "version": "1.0.0" }, "servers": [ { "url": "https://www.wander-service.fr/api/clients" } ], "tags": [ { "name": "Clients' login", "description": "It requires a clientId & clientSecret or a refreshToken" }, { "name": "Direct Event Data Serving", "description": "It requires a client's accessToken" }, { "name": "Event Data Fetching and Storage", "description": "It requires a client's accessToken" }, { "name": "Client Data", "description": "It requires a client's accessToken" } ], "paths": { "/login": { "post": { "tags": [ "Clients' login" ], "summary": "Login", "description": "It generates a refreshToken valid for 7 days to relogin and an accessToken valid for 1 hour to use the next endpoints.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "description": "Allows you to log in with your clientId and clientSecret before receiving a refreshToken valid for 7 days, allowing you to log in again.", "properties": { "grantAccess": { "type": "string", "enum": [ "clientSecret" ] }, "clientId": { "type": "string" }, "clientSecret": { "type": "string" } }, "required": [ "grantAccess", "clientId", "clientSecret" ], "additionalProperties": false }, { "type": "object", "description": "Allows you to log in with the last refreshToken retrieved when you logged in", "properties": { "grantAccess": { "type": "string", "enum": [ "refreshToken" ] }, "refreshToken": { "type": "string" } }, "required": [ "grantAccess", "refreshToken" ], "additionalProperties": false } ] } } } }, "responses": { "201": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "description": "Token to be used for bearerAuth.", "type": "string" }, "expiresIn": { "description": "Time in seconds before accessToken expires.", "type": "number", "examples": [ 3600 ] }, "tokenType": { "type": "string", "examples": [ "Bearer" ] }, "refreshToken": { "description": "Token valid for 7 days to be used to relogin.", "type": "string" } } } } } }, "401": { "description": "Wrong clientId or clientSecret or refreshToken" } }, "security": [] } }, "/v2/get/events": { "post": { "tags": [ "Direct Event Data Serving" ], "summary": "Get events", "description": "Get events according to your filters. You can use it to serve a map or event stream.", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "categories": { "description": "It is a filter. By default, you get all the event categories.", "type": "array", "minItems": 1, "items": { "type": "string", "enum": [ "atelier", "brocante", "cinema", "conference", "enfants", "expo", "festival", "gastronomie", "livres", "loisirs", "meeting", "musique", "nature", "pro", "salon", "sciences", "soiree", "solidarite", "spectacle", "sport", "visite", "none" ], "examples": [ "spectacle", "musique" ] } }, "sources": { "description": "It is a filter. By default, you get all sources. Check the back office for possible values.", "type": "array", "minItems": 1, "items": { "type": "string", "examples": [ "fnac" ] } }, "locationFilter": { "description": "You can define a location filter corresponding to a circle or a rectangle.", "oneOf": [ { "type": "object", "properties": { "circle": { "description": "You can define the coordinates of a circle to get events in this circle.", "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.333333 ] }, "lat": { "type": "number", "examples": [ 48.866667 ] }, "maxDistance": { "description": "Distance in meters.", "type": "number", "examples": [ 500 ] } }, "required": [ "lng", "lat", "maxDistance" ] } } }, { "type": "object", "properties": { "rectangle": { "description": "You can define the coordinates of a rectangle to get events in this rectangle.", "type": "object", "properties": { "minLng": { "type": "number", "examples": [ 1.349014 ] }, "maxLng": { "type": "number", "examples": [ 3.349014 ] }, "minLat": { "type": "number", "examples": [ 47.864716 ] }, "maxLat": { "type": "number", "examples": [ 49.864716 ] } }, "required": [ "minLng", "maxLng", "minLat", "maxLat" ] } } } ] }, "datesFilter": { "oneOf": [ { "type": "object", "properties": { "minDate": { "description": "You can set the date after which you want your events to take place. By defaut the events you get take place after now. Warning, date must be in ISO format.", "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "maxDate": { "description": "You can set the date before which you want your events to take place. By defaut the events you get take place before next week. If you set the date too far in the future, this may affect the performance of the query. Warning, date must be in ISO format.", "type": "string", "examples": [ "2024-12-12T12:00:06.138Z" ] } } }, { "type": "object", "properties": { "isLive": { "description": "To get live events taking place in the next 3 hours.", "type": "boolean", "examples": [ true ] } } } ] }, "pricesFilter": { "type": "object", "properties": { "lowestPrice": { "description": "You can set the lowest price for the events you get.", "type": "number", "minValue": 0 }, "highestPrice": { "description": "You can set the highest price for the events you get.", "type": "number", "minValue": 0, "examples": [ 200 ] }, "hasKnownPrice": { "description": "By default you get also events without known prices.", "type": "boolean", "examples": [ false ] } } }, "limit": { "type": "number", "minimum": 1, "maximum": 500, "examples": [ 5 ] }, "pageNumber": { "type": "number", "min": 1, "examples": [ 1 ] }, "orderBy": { "description": "You can order the events you get by dates or by prices or by distance to a place definied with 'orderByDistance' or by last update dates to update your records. By default it's by ascendant endDates.", "type": "string", "enum": [ "startDate", "endDate", "updatedAt", "lowestPrice", "highestPrice", "distance" ], "examples": [ "distance" ] }, "orderByDistance": { "description": "You can define the coordinates of a place to order events according to their distance from that place.", "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.333333 ] }, "lat": { "type": "number", "examples": [ 48.866667 ] } }, "required": [ "lng", "lat" ] }, "getCommentaries": { "description": "Set it to true if you want to retrieve commentaries on events you get. Warning, this reduces the performance of the request, so only use it if you want to use this data.", "type": "boolean", "examples": [ false ] }, "getPerformers": { "description": "Set it to true if you want to retrieve performers on events you get. Warning, this reduces the performance of the request, so only use it if you want to use this data.", "type": "boolean", "examples": [ false ] } } } } } }, "responses": { "201": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } }, "pagination": { "type": "object", "properties": { "totalItems": { "type": "number", "examples": [ 1000 ] }, "totalPages": { "type": "number", "examples": [ 20 ] }, "perPage": { "type": "number", "examples": [ 50 ] }, "currentPage": { "type": "number", "examples": [ 5 ] }, "nextPageParams": { "type": [ "object", "null" ], "properties": { "pageNumber": { "type": "number", "examples": [ 6 ] }, "limit": { "type": "number", "examples": [ 50 ] } } }, "previousPageParams": { "type": [ "object", "null" ], "properties": { "pageNumber": { "type": "number", "examples": [ 4 ] }, "limit": { "type": "number", "examples": [ 50 ] } } } } } } } } } }, "400": { "description": "Invalid body schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } }, "/v2/get/catalogue": { "post": { "tags": [ "Event Data Fetching and Storage" ], "summary": "Get events catalogue", "description": "Get and store all events. You can use it to keep your database up to date.", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "locationFilter": { "description": "You can define a location filter corresponding to a circle or a rectangle.", "oneOf": [ { "type": "object", "properties": { "circle": { "description": "You can define the coordinates of a circle to get events in this circle.", "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.333333 ] }, "lat": { "type": "number", "examples": [ 48.866667 ] }, "maxDistance": { "description": "Distance in meters.", "type": "number", "examples": [ 5000 ] } }, "required": [ "lng", "lat", "maxDistance" ] } } }, { "type": "object", "properties": { "rectangle": { "description": "You can define the coordinates of a rectangle to get events in this rectangle.", "type": "object", "properties": { "minLng": { "type": "number", "examples": [ 1.349014 ] }, "maxLng": { "type": "number", "examples": [ 3.349014 ] }, "minLat": { "type": "number", "examples": [ 47.864716 ] }, "maxLat": { "type": "number", "examples": [ 49.864716 ] } }, "required": [ "minLng", "maxLng", "minLat", "maxLat" ] } } } ] }, "lastUpdatedAt": { "description": "You can only get the events updated after this date. Use it to keep your own database up to date.", "type": "string", "examples": [ "2024-10-10T12:00:06.138Z" ] }, "trackAvailabilities": { "description": "Set it to true if you want to retrieve events whose availabilities have been modified.", "type": "boolean", "examples": [ false ] }, "limit": { "type": "number", "minimum": 1, "maximum": 500, "examples": [ 5 ] }, "pageNumber": { "type": "number", "min": 1, "examples": [ 1 ] } } } } } }, "responses": { "201": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } }, "eventIdsCancelled": { "description": "It's the event ids of events cancelled between \"getEventsUpdatedAfterDate\" and now.", "type": "array", "items": { "type": "number" } }, "eventIdsNotAvailable": { "description": "It's the event ids of the events made unavailable between \"getEventsUpdatedAfterDate\" and now.", "type": "array", "items": { "type": "number" } }, "eventIdsPassed": { "description": "It's the event ids of events whose end date has passed between \"getEventsUpdatedAfterDate\" and now.", "type": "array", "items": { "type": "number" } }, "eventIdsDeleted": { "description": "It's the event ids of the events deleted between \"getEventsUpdatedAfterDate\" and now.", "type": "array", "items": { "type": "number" } } } }, "pagination": { "type": "object", "properties": { "totalItems": { "type": "number", "examples": [ 1000 ] }, "totalPages": { "type": "number", "examples": [ 20 ] }, "perPage": { "type": "number", "examples": [ 50 ] }, "currentPage": { "type": "number", "examples": [ 5 ] }, "nextPageParams": { "type": [ "object", "null" ], "properties": { "pageNumber": { "type": "number", "examples": [ 6 ] }, "limit": { "type": "number", "examples": [ 50 ] } } }, "previousPageParams": { "type": [ "object", "null" ], "properties": { "pageNumber": { "type": "number", "examples": [ 4 ] }, "limit": { "type": "number", "examples": [ 50 ] } } } } } } } } } }, "400": { "description": "Invalid body schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } }, "/v2/event/{eventId}": { "get": { "tags": [ "Direct Event Data Serving" ], "summary": "Get event", "description": "Get event's whole informations. You can use it to create a page for the event.", "parameters": [ { "name": "eventId", "in": "path", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } }, "application/xml": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } } } }, "400": { "description": "Invalid param schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } }, "/v2/search": { "get": { "tags": [ "Direct Event Data Serving" ], "summary": "Dynamic search", "description": "Search for event or place or performer. You can use it for a searchbar.", "parameters": [ { "name": "searchInput", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "location[lng]", "description": "The coordinates [lng, lat] around which you are searching", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "location[lat]", "description": "The coordinates [lng, lat] around which you are searching", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "responseFilter", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "events", "places", "performers" ] } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "event": { "description": "Event object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "place": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'nbOfGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, ‘name’ is null, while for a sub-category, ‘name’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "name": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "score": { "type": "number", "description": "Search score" } } } } }, { "type": "object", "properties": { "place": { "description": "Place object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "score": { "type": "number", "description": "Search score" } } } } }, { "type": "object", "properties": { "performer": { "description": "Performer object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "isCertified": { "type": "boolean" }, "score": { "type": "number", "description": "Search score" } } } } } ] } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "event": { "description": "Event object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "place": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'nbOfGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, ‘name’ is null, while for a sub-category, ‘name’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "name": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "score": { "type": "number", "description": "Search score" } } }, "place": { "description": "Place object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "score": { "type": "number", "description": "Search score" } } }, "performer": { "description": "Performer object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "isCertified": { "type": "boolean" }, "score": { "type": "number", "description": "Search score" } } } } } } } } }, "400": { "description": "Invalid query schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } }, "/v2/g-place/{googlePlaceId}": { "get": { "tags": [ "Direct Event Data Serving" ], "summary": "Get place events", "description": "Fetch detailed information about a Google Place, including scheduled events.", "parameters": [ { "name": "googlePlaceId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "description": "Place object returned with '/v2/g-place/{googlePlaceId}'", "type": "object", "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } }, "events": { "type": "array", "items": { "type": "object", "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } ] } } } } }, "application/xml": { "schema": { "description": "Place object returned with '/v2/g-place/{googlePlaceId}'", "type": "object", "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } }, "events": { "type": "array", "items": { "type": "object", "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } ] } } } } } } }, "400": { "description": "Invalid param schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } }, "/v2/search/place": { "get": { "tags": [ "Direct Event Data Serving" ], "summary": "Search place events", "description": "Search for a place by name. A not-null result will only be returned if at least one event has already taken place at this place in our database.", "parameters": [ { "name": "input", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "location[lng]", "description": "The approximate longitude of the place you're searching for.", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "location[lat]", "description": "The approximate latitude of the place you are searching for.", "in": "query", "required": false, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "oneOf": [ { "description": "Place object returned with '/v2/g-place/{googlePlaceId}'", "type": "object", "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } }, "events": { "type": "array", "items": { "type": "object", "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } ] } } } }, { "type": "null" } ] } }, "application/xml": { "schema": { "oneOf": [ { "description": "Place object returned with '/v2/g-place/{googlePlaceId}'", "type": "object", "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } }, "events": { "type": "array", "items": { "type": "object", "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } ] } } } }, { "type": "null" } ] } } } }, "400": { "description": "Invalid query schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } }, "/v2/performer/{performerId}": { "get": { "tags": [ "Direct Event Data Serving" ], "summary": "Get performer events", "description": "Get performer's whole informations and the events in which they take part. You can use it to create a page for the performer.", "parameters": [ { "name": "performerId", "in": "path", "required": true, "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "description": "Performer object", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 300000 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] }, "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } } } } }, "application/xml": { "schema": { "description": "Performer object", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 300000 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] }, "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } } } } } } }, "400": { "description": "Invalid param schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } }, "/v2/search/performer": { "get": { "tags": [ "Direct Event Data Serving" ], "summary": "Search performer events", "description": "Search for a performer by name. A not-null result will only be returned if the performer's identity can be confidently confirmed and if at least one of their events is already recorded in our database.", "parameters": [ { "name": "input", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "oneOf": [ { "description": "Performer object", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 300000 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] }, "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } } } }, { "type": "null" } ] } }, "application/xml": { "schema": { "oneOf": [ { "description": "Performer object", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 300000 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] }, "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } } } }, { "type": "null" } ] } } } }, "400": { "description": "Invalid query schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } }, "/v2/clicks": { "get": { "tags": [ "Client Data" ], "summary": "Get clicks", "parameters": [ { "name": "lastClickedAt", "description": "Retrieves only clicks that occurred after the specified date.", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "number", "minimum": 1, "maximum": 1000 } }, { "name": "pageNumber", "in": "query", "schema": { "type": "number", "minimum": 1 } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "link": { "type": "string", "descritpion": "The affiliate link" }, "linkId": { "type": "number" }, "eventId": { "type": "number" }, "eventName": { "type": "string" }, "source": { "type": "string", "examples": [ "billetreduc" ] }, "commission": { "type": "number", "examples": [ 0.3 ] } } } }, "pagination": { "type": "object", "properties": { "totalItems": { "type": "number", "examples": [ 1000 ] }, "totalPages": { "type": "number", "examples": [ 20 ] }, "perPage": { "type": "number", "examples": [ 50 ] }, "currentPage": { "type": "number", "examples": [ 5 ] }, "nextPageParams": { "type": [ "object", "null" ], "properties": { "pageNumber": { "type": "number", "examples": [ 6 ] }, "limit": { "type": "number", "examples": [ 50 ] } } }, "previousPageParams": { "type": [ "object", "null" ], "properties": { "pageNumber": { "type": "number", "examples": [ 4 ] }, "limit": { "type": "number", "examples": [ 50 ] } } } } } } } } } }, "400": { "description": "Invalid query schema" }, "401": { "description": "Access token is missing or invalid" } }, "security": [ { "bearerAuth": [] } ] } } }, "components": { "responses": { "UnauthorizedError": { "description": "Access token is missing or invalid" } }, "schemas": { "EventV2": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } }, "PlaceV2": { "description": "Place object returned with '/v2/place/{placeId}'", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 200000 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Théâtre Fontaine" ] }, "description": { "type": [ "string", "null" ], "examples": [ "Le Théâtre Fontaine est une salle de spectacle parisienne" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "This is the average grade for the place on Google.", "type": [ "number", "null" ] }, "totalGrades": { "description": "This is the total number of grades for the place on Google.", "type": [ "number", "null" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "schedules": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 1 ] }, "timeZone": { "type": "string", "examples": [ "Europe/Paris" ] }, "startMinute": { "type": [ "number", "null" ], "examples": [ 570 ] }, "endMinute": { "type": [ "number", "null" ], "examples": [ 1050 ] }, "secondStartMinute": { "type": [ "number", "null" ], "examples": [ 1200 ] }, "secondEndMinute": { "type": [ "number", "null" ], "examples": [ 1350 ] } } } }, "events": { "type": "array", "items": { "type": "object", "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } ] } } } }, "GooglePlaceWithEvents": { "description": "Place object returned with '/v2/g-place/{googlePlaceId}'", "type": "object", "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } }, "events": { "type": "array", "items": { "type": "object", "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } ] } } } }, "PerformerWithEventsV2": { "description": "Performer object", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 300000 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] }, "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderLink": { "type": "string", "examples": [ "https://wander-app.fr/event/100000-plk-en-concert-accor-arena" ], "description": "Link to the event in the Wander app" }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price.", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price.", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "hasGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.", "type": "boolean" }, "image": { "type": [ "string", "null" ] }, "imageHeight": { "type": [ "number", "null" ] }, "imageWidth": { "type": [ "number", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "webImage": { "description": "This is the image compressed.", "type": [ "string", "null" ] }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "cancelledAt": { "type": [ "string", "null" ], "description": "This is the date on which the event was cancelled.", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "updatedAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "googlePlace": { "description": "Contains enriched place information retrieved from the Google Places API.", "type": [ "object", "null" ], "properties": { "id": { "type": "string", "examples": [ "ChIJi4rRh5jVEEgRm5kJBs9ZLSY" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "string", "examples": [ "8 Bd de Bercy, 75012 Paris, France" ], "description": "The formatted address of the place." }, "lng": { "type": "number", "examples": [ 2.3784703 ] }, "lat": { "type": "number", "examples": [ 48.8386038 ] }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 4.4 ] }, "totalGrades": { "type": [ "number", "null" ], "examples": [ 33620 ] }, "street": { "type": [ "string", "null" ], "examples": [ "8 Boulevard de Bercy" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75012 ] }, "country": { "type": [ "string", "null" ], "examples": [ "FR" ] }, "photoRef": { "type": [ "string", "null" ], "examples": [ "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "website": { "type": [ "string", "null" ], "examples": [ "https://www.accorarena.com/fr" ] }, "editorialSummary": { "type": [ "string", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details" }, "periods": { "type": [ "array", "null" ], "description": "Description on https://developers.google.com/maps/documentation/places/web-service/details", "items": { "type": "object", "properties": { "open": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ "0900" ] } } }, "close": { "type": "object", "properties": { "day": { "type": "number", "examples": [ 0 ] }, "time": { "type": "string", "examples": [ 1800 ] } } } } } } } }, "place": { "description": "Represents the original place information as provided by ticketing partners.", "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "googleId": { "type": "string", "description": "The unique identifier of the place in the Google Places API.", "examples": [ "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA" ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "averageGrade": { "description": "Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.", "type": [ "number", "null" ] }, "totalGrades": { "description": "Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.", "type": [ "number", "null" ] } } }, "sources": { "descritpion": "It's all the informations and ticket sources for the event (ex. Fnac, Ticketmaster, BilletReduc, etc.)", "type": "array", "items": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } } }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "subCategory": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "commentaries": { "description": "During integration, we retrieve all the comments/grades made about the event.", "type": "array", "items": { "type": "object", "properties": { "grade": { "type": "number", "examples": [ 5 ] }, "content": { "type": [ "string", "null" ], "examples": [ "Amazing concert !" ] }, "username": { "type": "string", "examples": [ "Wander bot" ] }, "date": { "type": "string" } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "trendingScore": { "type": "number", "examples": [ 10 ] }, "performers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } } } } } } } }, "EventForSearchV2": { "description": "Event object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "wanderId": { "type": "integer", "format": "int64", "examples": [ 100000 ] }, "name": { "type": "string", "examples": [ "PLK en concert" ] }, "startDate": { "type": "string", "examples": [ "2024-03-03 06:08:23.222 +0100" ] }, "endDate": { "type": "string", "examples": [ "2024-03-04 06:08:23.222 +0100" ] }, "hasEndDateNotReliable": { "type": "boolean" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "description": { "type": "string", "examples": [ "Un super concert de PLK à l'accor arena !" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "place": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } } } }, "averageGrade": { "description": "During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.", "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "description": "During integration, we also retrieve all the comments/grades made about the event. 'nbOfGrades' is simply the number of these ratings.", "type": "number", "examples": [ 1 ] }, "categories": { "description": "It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, ‘name’ is null, while for a sub-category, ‘name’ is not null and ‘mainCategory’ has the same value as the main category.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "number", "format": "int64", "examples": [ 1 ] }, "name": { "description": "If it's null, it's a main category, otherwise it's a sub-category of the main category.", "type": [ "string", "null" ], "examples": [ "painting" ] }, "mainCategory": { "type": "string", "examples": [ "expo" ] }, "traductionFR": { "type": "string", "examples": [ "peinture" ] }, "traductionEN": { "type": "string", "examples": [ "painting" ] }, "icon": { "type": "string" } } } }, "score": { "type": "number", "description": "Search score" } } }, "PlaceForSearchV2": { "description": "Place object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "Accor Arena" ] }, "address": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "score": { "type": "number", "description": "Search score" } } }, "PerformerForSearch": { "description": "Performer object returned with '/search'", "type": [ "object", "null" ], "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 10 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "squareImage": { "type": [ "string", "null" ] }, "rectangleImage": { "type": [ "string", "null" ] }, "isCertified": { "type": "boolean" }, "score": { "type": "number", "description": "Search score" } } }, "AddressV2": { "type": "object", "properties": { "lng": { "type": "number", "examples": [ 2.123909 ] }, "lat": { "type": "number", "examples": [ 42.32981038 ] }, "street": { "type": [ "string", "null" ], "examples": [ "Rue Saint-Jacques" ] }, "city": { "type": [ "string", "null" ], "examples": [ "Paris" ] }, "postalCode": { "type": [ "string", "null" ], "examples": [ 75005 ] }, "country": { "type": [ "string", "null" ], "examples": [ "France" ] } } }, "EventSourceV2": { "type": "object", "description": "This is one of the sources of information about the event", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "partner": { "type": "object", "properties": { "name": { "type": "string", "examples": [ "fnac" ] }, "logo": { "type": "string" }, "backColor": { "type": "string" } } }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "lowestPrice": { "type": [ "number", "null" ], "description": "The lowest price for the event in euros. If it's null, we don't know the price", "examples": [ 0 ] }, "highestPrice": { "type": [ "number", "null" ], "description": "The highest price for the event in euros. If it's null, we don't know the price", "examples": [ 200 ] }, "isGoodDeal": { "description": "This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).", "type": "boolean" }, "commissionFix": { "description": "Deprecated, use \"commissionPerTicket\" and \"commissionPerCart\" instead.", "type": "number", "examples": [ 1 ] }, "commissionPerTicket": { "type": "number", "examples": [ 1 ] }, "commissionPerCart": { "type": "number", "examples": [ 1 ] }, "commissionRate": { "type": "number", "examples": [ 0.05 ] }, "link": { "type": "string", "description": "The affiliate link to buy tickets." }, "isBookable": { "type": "boolean" }, "availableDates": { "description": "This corresponds to all the dates available for this event and for this particular source.", "type": "array", "items": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "hasEndDateNotReliable": { "type": "boolean" }, "hasUnknownAvailability": { "type": "boolean" } } } }, "averageGrade": { "type": [ "number", "null" ], "examples": [ 5 ] }, "totalGrades": { "type": "number", "examples": [ 1 ] }, "cantRetrieveAvailableDates": { "description": "For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.", "type": "boolean" }, "notAvailableAt": { "type": [ "string", "null" ], "description": "This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability." } } }, "Performer": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "examples": [ 45 ] }, "name": { "type": "string", "examples": [ "PLK" ] }, "description": { "type": [ "string", "null" ] }, "image": { "type": [ "string", "null" ] }, "webImage": { "type": [ "string", "null" ] } } }, "ClientClick": { "type": "object", "properties": { "createdAt": { "type": "string", "examples": [ "2024-09-12T12:00:06.138Z" ] }, "link": { "type": "string", "descritpion": "The affiliate link" }, "linkId": { "type": "number" }, "eventId": { "type": "number" }, "eventName": { "type": "string" }, "source": { "type": "string", "examples": [ "billetreduc" ] }, "commission": { "type": "number", "examples": [ 0.3 ] } } } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "It is the \"access_token\" returned after login" } } } }