API Documentation

API Endpoints

Info

Welcome to the EvntMngr API documentation! Our API endpoints provide streamlined interactions with the core features of the EvntMngr App, including Events, Artists, Promoters and Venues. With our endpoints, you can add, remove, edit or retrieve information about these entities, empowering you to manage your event-related data efficiently and effectively. Whether you're creating event listings, showcasing artists, partnering with promoters or managing venues, our API simplifies the process, allowing you to focus on delivering exceptional experiences to your users.

Authentication

Authentication is required for accessing various endpoints in the EvntMngr Web App's API. While GET requests to some endpoints are public and do not require authentication, other HTTP methods like POST, PUT, and DELETE require an API Key authentication for all endpoints.

API Key

You can generate an API Key on your user profile.

API Key Header

X-Api-Key: your-api-key

Public Endpoints

GET Events List

GET Artists List

GET Venues List

GET Promoters List

Events Endpoint

Info

Endpoint: https://evntmngr.xyz/api/events/
Description: Perform operations related to your events

Methods:

GET: Retrieve a list of events or information about a specific event
POST: Create a new event
PUT: Update event details
DELETE: Delete an event

Authentication:

API Key required for GET, POST, PUT, and DELETE

GET - List

GET example.com/api/events/
Content-Type: application/json
X-Api-Key: your-api-key

GET - Individual

GET https://evntmngr.xyz/api/events/event_id/
Content-Type: application/json
X-Api-Key: your-api-key

POST

POST https://evntmngr.xyz/api/events/
Content-Type: application/json
X-Api-Key: your-api-key

{
"name": "Event Name",
"event_date": "2024-01-31",
"venue": "Venue ID"
"event_flyer": "event flyer url"
}

PUT

PUT https://evntmngr.xyz/api/events/event_id/
Content-Type: application/json
X-Api-Key: your-api-key

{
"name": "Event Name",
"event_date": "2024-01-31",
"venue": "Venue ID"
"event_flyer": "event flyer url"
}

DELETE

DELETE https://evntmngr.xyz/api/events/event_id/
Content-Type: application/json
X-Api-Key: your-api-key

Artists Endpoint

Info

Endpoint: https://evntmngr.xyz/api/artists/
Description: Perform operations related to your artists

Methods:

GET: Retrieve a list of artists or information about a specific artist
POST: Create a new artist
PUT: Update artist details
DELETE: Delete an artist

Authentication:

API Key required for GET, POST, PUT, and DELETE

GET - List

GET https://evntmngr.xyz/api/artists/
Content-Type: application/json
X-Api-Key: your-api-key

GET - Individual

GET https://evntmngr.xyz/api/artists/artist_id/
Content-Type: application/json
X-Api-Key: your-api-key

POST

POST https://evntmngr.xyz/api/artists/
Content-Type: application/json
X-Api-Key: your-api-key

{
"name": "Artist Name",
"email": "artist@email.com",
"city": "Vienna",
"country": "AT",
"image": "image url"
}

PUT

PUT https://evntmngr.xyz/api/artists/artist_id/
Content-Type: application/json
X-Api-Key: your-api-key

{
"name": "Artist Name",
"email": "artist@email.com",
"city": "Vienna",
"country": "AT",
"image": "image url"
}

DELETE

DELETE https://evntmngr.xyz/api/artists/artist_id/
Content-Type: application/json
X-Api-Key: your-api-key

Venues Endpoint

Info

Endpoint: https://evntmngr.xyz/api/venues/
Description: Perform operations related your to venues

Methods:

GET: Retrieve a list of venues or information about a specific venue
POST: Create a new venue
PUT: Update venue details
DELETE: Delete a venue

Authentication:

API Key required for GET, POST, PUT, and DELETE

GET - List

GET https://evntmngr.xyz.com/api/venues/
Content-Type: application/json
X-Api-Key: your-api-key

GET - Individual

GET https://evntmngr.xyz.com/api/venues/venue_id/
Content-Type: application/json
X-Api-Key: your-api-key

POST

POST https://evntmngr.xyz/api/venues/
Content-Type: application/json
X-Api-Key: your-api-key

{
"name": "Bao Bar",
"city": "Vienna",
}

PUT

PUT https://evntmngr.xyz/api/venues/venue_id/
Content-Type: application/json
X-Api-Key: your-api-key

{
"name": "Bao Bar",
"city": "Vienna",
}

DELETE

DELETE https://evntmngr.xyz/api/venues/venue_id/
Content-Type: application/json
X-Api-Key: your-api-key

Promoters Endpoint

Info

Endpoint: https://evntmngr.xyz/api/promoters/
Description: Perform operations related to your promoters

Methods:

GET Retrieve a list of promoters or information about a specific promoter
POST Create a new promoter
PUT Update promoter details
DELETE Delete a promoter

Authentication:

API Key required for GET, POST, PUT, and DELETE

GET - List

GET https://evntmngr.xyz.com/api/promoters/
Content-Type: application/json
X-Api-Key: your-api-key

GET - Individual

GET https://evntmngr.xyz.com/api/promoters/promoter_id/
Content-Type: application/json
X-Api-Key: your-api-key

POST

POST https://evntmngr.xyz/api/promoters/
Content-Type: application/json
X-Api-Key: your-api-key

{
"name": "Promoter Name",
"city": "Vienna",
"email": "email@promoter.com"
"website": "https://promoter.com"
}

PUT

PUT https://evntmngr.xyz/api/promoters/promoter-id/
Content-Type: application/json
X-Api-Key: your-api-key

{
"name": "Promoter Name",
"city": "Vienna",
"email": "email@promoter.com"
"website": "https://promoter.com"
}

DELETE

DELETE https://evntmngr.xyz/api/promoters/promoter-id/
X-Api-Key: your-api-key
Content-Type: application/json