> ## Documentation Index > Fetch the complete documentation index at: https://docs.wander-app.fr/llms.txt > Use this file to discover all available pages before exploring further. # Get events > Get events according to your filters. You can use it to serve a map or event stream. ## OpenAPI ````yaml api-reference/openapi.json post /v2/get/events 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. **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 security: [] 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: /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: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: It is the "access_token" returned after login ````