Get events

GET

events

curl --request GET \
  --url https://api-alpha.fourvenues.com/integrations/events/ \
  --header 'integration_id: <api-key>' \
  --header 'secret: <api-key>' \
  --header 'x-api-key: <api-key>'

{
  "success": true,
  "data": [
    {
      "_id": "Pl4gr84v20xqu01js0ybj42s6vYtIz1T",
      "date": 1664143200,
      "end": 1663911000,
      "flyer": "https://www.your-domain.com/flyer.jpg",
      "name": "Saturday Night",
      "slug": "saturday-night-26-09-2022",
      "start": 1663884000,
      "url": "https://www.fourvenues.com/gengis-kan/events/saturday-night-26-09-2022",
      "description": "This event takes place every Thursday",
      "age": 18,
      "music_genres": "techno",
      "outfit": "casual",
      "location_town": "Madrid",
      "artists": [
        "David Guetta",
        "Martin Garrix"
      ]
    }
  ]
}

Authorizations

integration_id

string

header

required

Identifier of the integration (Auth v1)

secret

string

header

required

Secret of the organization (Auth v1)

x-api-key

string

header

required

API key (Auth v2)

Query Parameters

start

string

Date of event (ISO 8601).

end

string

Date of event (ISO 8601).

Response

200

application/json

HTTP OK

success

boolean

Example:

true

data

object[]

Array of Event

data._id

string

Unique ID of the event.

Example:

"Pl4gr84v20xqu01js0ybj42s6vYtIz1T"

data.date

integer

Start of the day of the event (unix).

Example:

1664143200

data.end

integer

End date of the event (unix).

Example:

1663911000

data.flyer

string

Flyer.

Example:

"https://www.your-domain.com/flyer.jpg"

data.name

string

Name of the event.

Example:

"Saturday Night"

data.slug

string

Slug.

Example:

"saturday-night-26-09-2022"

data.start

integer

Start date of the event (unix).

Example:

1663884000

data.url

string

URL of the event.

Example:

"https://www.fourvenues.com/gengis-kan/events/saturday-night-26-09-2022"

data.description

string

Description of the event.

Example:

"This event takes place every Thursday"

data.age

number

Min age of the event.

Example:

18

data.music_genres

enum<string>

Event music genres.

Available options:

hits,

urban,

pop,

rock,

remember,

techno,

house,

edm,

trap,

reggaeton,

latin,

salsa,

bachata,

kizomba,

r&b,

dance,

indie,

afrobeat,

minimal,

underground,

tech-house,

drum-and-bass,

acid-house,

chill,

hard-techno,

melodic-techno,

hip-hop,

reggae,

disco,

sing-along,

acoustic,

trance,

classical,

soul,

blues,

jazz,

metal,

old-school

Example:

"techno"

data.outfit

enum<string>

Outfit of the event.

Available options:

free,

casual,

half-label,

label,

fixed-up

Example:

"casual"

data.location_town

string

Town where the event will take place.

Example:

"Madrid"

data.artists

string[]

Artists of the event.

Example:

["David Guetta", "Martin Garrix"]

Get event by id Get bookings

curl --request GET \
  --url https://api-alpha.fourvenues.com/integrations/events/ \
  --header 'integration_id: <api-key>' \
  --header 'secret: <api-key>' \
  --header 'x-api-key: <api-key>'

{
  "success": true,
  "data": [
    {
      "_id": "Pl4gr84v20xqu01js0ybj42s6vYtIz1T",
      "date": 1664143200,
      "end": 1663911000,
      "flyer": "https://www.your-domain.com/flyer.jpg",
      "name": "Saturday Night",
      "slug": "saturday-night-26-09-2022",
      "start": 1663884000,
      "url": "https://www.fourvenues.com/gengis-kan/events/saturday-night-26-09-2022",
      "description": "This event takes place every Thursday",
      "age": 18,
      "music_genres": "techno",
      "outfit": "casual",
      "location_town": "Madrid",
      "artists": [
        "David Guetta",
        "Martin Garrix"
      ]
    }
  ]
}

Introduction

API Reference

Recipes

Authorizations

Query Parameters

Response