Get Event By Event ID

Introduction

The Get Event By Event ID API provides detailed information about a specific event based on the event ID. You can use this API to retrieve event details such as event name, venue, start date, event slots, and more.

Retrieve Event

To retrieve an event, you need to send an HTTP POST request to the following endpoint:

Endpoint

https://api.paydexp.com/v1/event/{event_id}

Authorization

Users need to include basic authentication credentials in the request headers.

AUTHORIZATION: Basic Auth

Username  <username>
Password  <password>

Code Examples

Below are code examples in different programming languages demonstrating how to retrieve event details using HTTP POST requests.

Curl

curl --location --request POST 'https://api.paydexp.com/api/v1/event/79' \
--header 'Authorization: ••••••'

Go

package main

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

func main() {

    url := "https://api.paydexp.com/api/v1/event/79"
    method := "POST"

    client := &http.Client {
    }
    req, err := http.NewRequest(method, url, nil)

    if err != nil {
        fmt.Println(err)
        return
    }
    req.Header.Add("Authorization", "••••••")

    res, err := client.Do(req)
    if err != nil {
        fmt.Println(err)
        return
    }
    defer res.Body.Close()

    body, err := io.ReadAll(res.Body)
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(string(body))
}

Nodejs

const axios = require('axios');

let config = {
    method: 'post',
    maxBodyLength: Infinity,
    url: 'https://api.paydexp.com/api/v1/event/79',
    headers: { 
        'Authorization': '••••••'
    }
};

axios.request(config)
.then((response) => {
    console.log(JSON.stringify(response.data));
})
.catch((error) => {
    console.log(error);
});

Python

import requests

url = "https://api.paydexp.com/api/v1/event/79"

payload = {}
headers = {
    'Authorization': '••••••'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.paydexp.com/api/v1/event/79');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
    'follow_redirects' => TRUE
));
$request->setHeader(array(
    'Authorization': '••••••'
));
try {
    $response = $request->send();
    if ($response->getStatus() == 200) {
        echo $response->getBody();
    }
    else {
        echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
        $response->getReasonPhrase();
    }
}
catch(HTTP_Request2_Exception $e) {
    echo 'Error: ' . $e->getMessage();
}

Example of a successful response

{
    "success": true,
    "data": {
        "id": 79,
        "parent_id": null,
        "is_sub_event": 0,
        "slug": "music-party",
        "name": "Music Party",
        "description": "<h2>Ring in the New Year with a Symphony of Beats: Music Party!</h2><p><strong>This New Year's Eve, let's not just watch the clock strike twelve - let's dance our way into 2025!</strong></p><p>Join us for a <strong>music party</strong> unlike any other, a night bursting with infectious rhythms and electrifying energy. As the year draws to a close, we'll celebrate with a <strong>journey through music</strong>, from dancefloor classics to the hottest new tracks.</p><p><strong>Here's what awaits you:</strong></p><ul><li><strong>Live DJs spinning a diverse mix:</strong> Get ready to groove to all your favorite genres! From pop anthems that will have you singing along to heart-pounding bass drops, our DJs will keep you moving all night long.</li><li><strong>Festive atmosphere:</strong> We'll transform the venue into a dazzling wonderland, setting the perfect scene for an unforgettable celebration.</li><li><strong>Countdown to midnight:</strong> Let's raise a toast and shower in confetti as we welcome the New Year together!</li><li><strong>Open bar (optional):</strong> Mingle with friends and fellow music lovers, drinks flowing all night (check the event page for details).</li></ul><p><strong>Don't miss this chance to create unforgettable memories as we dance our way into a brand new year!</strong></p><p><strong>Limited tickets available, grab yours now!</strong></p><p><strong>#NewYearsEveParty #MusicParty #DanceInto2025</strong></p>",
        "venue": "Geco Cafe",
        "instructions": "Come with your dancing shoes!",
        "status": "completed",
        "currency": "KES",
        "is_sold_out": 0,
        "slots": 0,
        "video": null,
        "pay_later": 1,
        "is_public": 0,
        "is_online": 0,
        "online_link": null,
        "is_refundable": 0,
        "deduct_type": "percentage",
        "deduct_value": 0,
        "approval": 0,
        "images_path": "https://beta.paydexp.com/web/images/event-imgs/1711600982.jpg",
        "map_image_path": "https://beta.paydexp.com/web/images/event-imgs/1715349103.png",
        "event_start_date": "2024-06-11 20:00:00",
        "event_end_date": "2024-06-11 22:25:00",
        "event_book_start_date": "2024-06-11 20:00:00",
        "event_book_end_date": "2024-06-11 22:25:00",
        "event_images": [],
        "categories": [
            {
                "slug": "festivals",
                "name": "Festivals",
                "description": "Festival events"
            }
        ],
        "event_slots": [
            {
                "id": 49,
                "is_active": true,
                "is_sold_out": false,
                "deleted_at": null,
                "gates_open_at": "11th June 2024, 08:00 PM"
            }
        ]
    },
    "message": "Event retrieved successfully."
}

Conclusion

The Get Event By Event ID API provides detailed information about a specific event based on the event ID. You can use this API to retrieve event details such as event name, venue, start date, event slots, and more.