Skip to main content
GET
/
events
Get all events
curl --request GET \
  --url https://channels-service-alpha.fourvenues.com/events \
  --header 'X-Api-Key: <api-key>'
import requests

url = "https://channels-service-alpha.fourvenues.com/events"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://channels-service-alpha.fourvenues.com/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://channels-service-alpha.fourvenues.com/events",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://channels-service-alpha.fourvenues.com/events"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("X-Api-Key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://channels-service-alpha.fourvenues.com/events")
.header("X-Api-Key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://channels-service-alpha.fourvenues.com/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "data": [
    {
      "_id": "abcdefghi1234567890",
      "name": "Monday Night",
      "slug": "monday-night",
      "description": "Lorem ipsum",
      "age": "18",
      "outfit": "casual",
      "ambiences": [
        "alternative"
      ],
      "music_genres": [
        "bachata"
      ],
      "artists": [
        {
          "name": "C. Tangana",
          "image_url": "https://somecdn.com/random-hash"
        }
      ],
      "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",
      "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"
      },
      "event_group": {
        "_id": "p03zns27fhz7opf9lqulc1scg9ke5z1y",
        "organization_id": "Mjo4f9o9h01fdjvmmrgn9aoh4s5IBHzX",
        "name": "CM EVENTS",
        "event_ids": [
          "<string>"
        ],
        "description": "<string>"
      },
      "ticket_rates": [
        {
          "organization_id": "abcdefghi1234567890",
          "event_id": "abcdefghi1234567890",
          "name": "General Access",
          "slug": "general-access",
          "valid_from": "2022-01-01T00:00:00.000Z",
          "complete": false,
          "type": "limited",
          "prices": [
            {
              "price": 12,
              "valid_until": "2022-01-01T00:00:00.000Z",
              "quantity": 0,
              "includes": "1 Drink",
              "additional_info": "Only valid before 2:00 am.",
              "_id": "1643064796675",
              "name": "Early Bird",
              "fee_type": "percentage",
              "fee_quantity": 10,
              "used": "55"
            }
          ],
          "supplements": [
            {
              "_id": "1643064796675",
              "label": "1 Copa",
              "price": 12,
              "has_fake_price": true,
              "fake_price": 15,
              "description": "Includes one drink at the bar",
              "product_quantity": 4,
              "purchase_limit": {
                "min_quantity": 2,
                "max_quantity": 8,
                "is_unlimited": false
              },
              "redemption_deadline": {
                "is_expiration_enabled": true,
                "expiration_deadline": 1798851600
              },
              "service_charge_amount": 15,
              "service_charge_type": "percentage"
            }
          ],
          "available": true,
          "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"
              ]
            }
          ],
          "_id": "abcdefghi1234567890",
          "show_all_prices": true,
          "current_price": {
            "price": 12,
            "valid_until": "2022-01-01T00:00:00.000Z",
            "quantity": 0,
            "includes": "1 Drink",
            "additional_info": "Only valid before 2:00 am.",
            "_id": "1643064796675",
            "name": "Early Bird",
            "fee_type": "percentage",
            "fee_quantity": 10,
            "used": "55"
          },
          "warranty": {
            "enabled": true,
            "percentage": 20,
            "hours": 12
          },
          "has_discount_codes_enabled": true
        }
      ],
      "iframe": {
        "tag_url": "https://fourvenues.com/assets/org-slug/event-code",
        "script_url": "https://fourvenues.com/assets/iframe/org-slug/event-code"
      },
      "currency": "EUR"
    }
  ],
  "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 additional options separated by comma.

Default response already includes location, artists, preregister status (is_preregistered) and preregister configuration (preregister).

Populate options:

  • *: All populators
  • ticket-rates: Ticket Rates
  • list-rates: List Rates
  • event-groups: Event Groups
  • preregister: Preregister status and configuration

Each word in search must be in the events name to return it. 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

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<int32>
default:50

Limit the number of events returned.

offset
integer<int32>
default:0

Offset the events returned.

Response

OK

data
object[]
success
boolean