POST
/
v2
/
get
/
events
Get events
curl --request POST \
  --url https://www.wander-service.fr/api/clients/v2/get/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "categories": [
    "spectacle"
  ],
  "sources": [
    "fnac"
  ],
  "locationFilter": {
    "circle": {
      "lng": 2.333333,
      "lat": 48.866667,
      "maxDistance": 500
    }
  },
  "datesFilter": {
    "minDate": "2024-09-12T12:00:06.138Z",
    "maxDate": "2024-12-12T12:00:06.138Z"
  },
  "pricesFilter": {
    "lowestPrice": 123,
    "highestPrice": 200,
    "hasKnownPrice": false
  },
  "limit": 5,
  "pageNumber": 1,
  "orderBy": "distance",
  "orderByDistance": {
    "lng": 2.333333,
    "lat": 48.866667
  },
  "getCommentaries": false,
  "getPerformers": false
}'
{
  "data": [
    {
      "id": 100000,
      "wanderId": 100000,
      "wanderLink": "https://wander-app.fr/event/100000-plk-en-concert-accor-arena",
      "name": "PLK en concert",
      "startDate": "2024-03-03 06:08:23.222 +0100",
      "endDate": "2024-03-04 06:08:23.222 +0100",
      "hasEndDateNotReliable": true,
      "lowestPrice": 0,
      "highestPrice": 200,
      "description": "Un super concert de PLK à l'accor arena !",
      "hasGoodDeal": true,
      "image": "<string>",
      "imageHeight": 123,
      "imageWidth": 123,
      "squareImage": "<string>",
      "rectangleImage": "<string>",
      "webImage": "<string>",
      "notAvailableAt": "2024-09-12T12:00:06.138Z",
      "cancelledAt": "2024-09-12T12:00:06.138Z",
      "createdAt": "2024-09-12T12:00:06.138Z",
      "updatedAt": "2024-09-12T12:00:06.138Z",
      "googlePlace": {
        "id": "ChIJi4rRh5jVEEgRm5kJBs9ZLSY",
        "name": "Accor Arena",
        "address": "8 Bd de Bercy, 75012 Paris, France",
        "lng": 2.3784703,
        "lat": 48.8386038,
        "averageGrade": 4.4,
        "totalGrades": 33620,
        "street": "8 Boulevard de Bercy",
        "city": "Paris",
        "postalCode": 75012,
        "country": "FR",
        "photoRef": "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S",
        "website": "https://www.accorarena.com/fr",
        "editorialSummary": "<string>",
        "periods": [
          {
            "open": {
              "day": 0,
              "time": "0900"
            },
            "close": {
              "day": 0,
              "time": 1800
            }
          }
        ]
      },
      "place": {
        "id": 10,
        "googleId": "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA",
        "name": "Accor Arena",
        "address": {
          "lng": 2.123909,
          "lat": 42.32981038,
          "street": "Rue Saint-Jacques",
          "city": "Paris",
          "postalCode": 75005,
          "country": "France"
        },
        "image": "<string>",
        "squareImage": "<string>",
        "rectangleImage": "<string>",
        "averageGrade": 123,
        "totalGrades": 123
      },
      "sources": [
        {
          "id": 45,
          "partner": {
            "name": "fnac",
            "logo": "<string>",
            "backColor": "<string>"
          },
          "startDate": "<string>",
          "endDate": "<string>",
          "lowestPrice": 0,
          "highestPrice": 200,
          "isGoodDeal": true,
          "commissionFix": 1,
          "commissionPerTicket": 1,
          "commissionPerCart": 1,
          "commissionRate": 0.05,
          "link": "<string>",
          "isBookable": true,
          "availableDates": [
            {
              "startDate": "<string>",
              "endDate": "<string>",
              "hasEndDateNotReliable": true,
              "hasUnknownAvailability": true
            }
          ],
          "averageGrade": 5,
          "totalGrades": 1,
          "cantRetrieveAvailableDates": true,
          "notAvailableAt": "<string>"
        }
      ],
      "categories": [
        {
          "id": 1,
          "mainCategory": "expo",
          "subCategory": "painting",
          "traductionFR": "peinture",
          "traductionEN": "painting",
          "icon": "<string>"
        }
      ],
      "commentaries": [
        {
          "grade": 5,
          "content": "Amazing concert !",
          "username": "Wander bot",
          "date": "<string>"
        }
      ],
      "averageGrade": 5,
      "totalGrades": 1,
      "trendingScore": 10,
      "performers": [
        {
          "id": 45,
          "name": "PLK",
          "description": "<string>",
          "image": "<string>",
          "webImage": "<string>"
        }
      ]
    }
  ],
  "pagination": {
    "totalItems": 1000,
    "totalPages": 20,
    "perPage": 50,
    "currentPage": 5,
    "nextPageParams": {
      "pageNumber": 6,
      "limit": 50
    },
    "previousPageParams": {
      "pageNumber": 4,
      "limit": 50
    }
  }
}

Authorizations

​
Authorization
string
header
required

It is the "access_token" returned after login

Body

application/json
​
categories
enum<string>[]

It is a filter. By default, you get all the event categories.

Minimum length: 1
​
sources
string[]

It is a filter. By default, you get all sources. Check the back office for possible values.

Minimum length: 1
​
locationFilter
object

You can define a location filter corresponding to a circle or a rectangle.

​
datesFilter
object
​
pricesFilter
object
​
limit
number
Required range: 1 <= x <= 500
Examples:

5

​
pageNumber
number
Examples:

1

​
orderBy
enum<string>

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.

Available options:
startDate,
endDate,
updatedAt,
lowestPrice,
highestPrice,
distance
Examples:

"distance"

​
orderByDistance
object

You can define the coordinates of a place to order events according to their distance from that place.

​
getCommentaries
boolean

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.

Examples:

false

​
getPerformers
boolean

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.

Examples:

false

Response

Successful operation

​
data
object[]
​
pagination
object