GET
/
events
Get all events
curl --request GET \
  --url https://channels-service-alpha.fourvenues.com/events \
  --header 'X-Api-Key: <api-key>'
{
  "data": [
    {
      "_id": "abcdefghi1234567890",
      "name": "Monday Night",
      "slug": "monday-night",
      "description": "Lorem ipsum",
      "display_date": "2023-12-31T00:00:00.000Z",
      "start_date": "2024-01-01T00:00:00.000Z",
      "end_date": "2024-01-01T06:00:00.000Z",
      "organization_id": "abcdefghi1234567890",
      "age": "18",
      "image_url": "https://somecdn.com/random-hash",
      "outfit": "casual",
      "ambiences": [
        "alternative"
      ],
      "music_genres": [
        "bachata"
      ],
      "artists": [
        {
          "name": "C. Tangana",
          "image_url": "https://somecdn.com/random-hash"
        }
      ],
      "location_id": "locAbcdefghi1234567890",
      "location": {
        "unic_id": "orgAbcdefghi1234567890-locAbcdefghi1234567890",
        "location_id": "5e4f4b1b1f6b4b001f6b4b001",
        "organization_id": "5e4f4b1b1f6b4b001f6b4b001",
        "name": "Valencia",
        "address": "Carrer de Salamanca",
        "number": "43",
        "city": "Valencia",
        "country": "Spain",
        "full_address": "Carrer de Salamanca, 43, Valencia, Spain",
        "latitude": 39.4651339,
        "longitude": -0.3658872,
        "timezone": "Europe/Madrid"
      },
      "ticket_rates": [
        {
          "_id": "abcdefghi1234567890",
          "organization_id": "abcdefghi1234567890",
          "event_id": "abcdefghi1234567890",
          "name": "General Access",
          "slug": "general-access",
          "valid_from": "2022-01-01T00:00:00.000Z",
          "complete": false,
          "type": "limited",
          "show_all_prices": true,
          "prices": [
            {
              "_id": "1643064796675",
              "name": "Early Bird",
              "price": 12,
              "valid_until": "2022-01-01T00:00:00.000Z",
              "quantity": 0,
              "fee_type": "percentage",
              "fee_quantity": 10,
              "includes": "1 Drink",
              "additional_info": "Only valid before 2:00 am."
            }
          ],
          "supplements": [
            {
              "_id": "1643064796675",
              "label": "1 Copa",
              "price": 12,
              "has_fake_price": false,
              "fake_price": 15
            }
          ],
          "available": true,
          "current_price": {
            "_id": "1643064796675",
            "name": "Early Bird",
            "price": 12,
            "valid_until": "2022-01-01T00:00:00.000Z",
            "quantity": 0,
            "fee_type": "percentage",
            "fee_quantity": 10,
            "includes": "1 Drink",
            "additional_info": "Only valid before 2:00 am."
          },
          "warranty": {
            "enabled": true,
            "percentage": 20,
            "hours": 12
          },
          "availability": {
            "sold": 10,
            "available": 90
          },
          "min": 1,
          "max": 10,
          "questions": [
            {
              "_id": "1643064796675",
              "label": "¿How did you hear about us?",
              "type": "dropdown",
              "required": true,
              "items": [
                "Instagram",
                "Appear"
              ]
            }
          ]
        }
      ],
      "iframe": {
        "tag_url": "https://fourvenues.com/assets/org-slug/event-code",
        "script_url": "https://fourvenues.com/assets/iframe/org-slug/event-code"
      }
    }
  ],
  "success": true
}

Authorizations

​
X-Api-Key
string
header
required

Query Parameters

​
organization_id
string

Filter the events by organization id.

​
start_date
string<iso>

Filter the events by start date.

​
end_date
string<iso>

Filter the events by end date.

​
populate
string

Populates the events with the options given separated by comma.<br>Populate options:<br>   -'*': All populators<br>   -'ticket-rates': Ticket Rates

​
search
string

Each word in search must be in the events name to return it.<br>Example if an event name is 'Fourvenues New Disco' and we search for 'fourven disc' the event should be returned.

​
location_id
string

Filter the events by location id.

​
lat
number

Filter by zone radius. Latitude of the center radius. This field is required if lng or radius are pass.

​
lng
number

Filter by zone radius. Longitude of the center radius. This field is required if lat or radius are pass

​
radius
number
default:5

Filter by zone radius. Radius of the zone to search in kilometers (Max 500). This field is required if lng or lat are pass

​
limit
integer
default:50

Limit the number of events returned.

​
offset
integer
default:0

Offset the events returned.

Response

200
application/json

OK

The response is of type object.