⚡ Black Friday & Cyber Monday Extended: 25% OFF! Use code BFCMEXT25 at checkout. Explore Plans
Skip to content
Home / Integrations / EventPrime API documentation

EventPrime API documentation

Overview

The EventPrime Rest API Integration allows you to connect and manage your EventPrime Events, Tickets, Venues, Organizers, Performers, Event Types, and Bookings through REST API endpoints.

Using these endpoints, you can create new Events, retrieve data, and connect EventPrime with other systems or custom applications.

The base endpoint for your site will look similar to:

https://yourdomain.com/wp-json/eventprime/v1/integration

Steps to Use EventPrime Endpoints

Before making any API calls, follow these steps carefully to ensure your EventPrime REST API works correctly.

Step 1: Enable the EventPrime REST API

  1. Go to your WordPress Dashboard.
  2. Navigate to EventPrime → Settings → API / Webhooks tab.
  3. Enable the API toggle.
  4. Copy the API Endpoint URL shown there.
    It will look similar to: https://yourdomain.com/wp-json/eventprime/v1/integration Use this as your base endpoint for all API requests.

Note: If the API is disabled, endpoints will return a “404 Not Found” error.

Step 2: Check WordPress Permalinks

EventPrime REST API requires pretty permalinks to work properly.
If your permalink structure is set to “Plain”, update it before using the API.

  1. Go to Settings → Permalinks in WordPress.
  2. Select any structure other than “Plain” (for example, “Post name”).
  3. Click Save Changes

Step 3: Authenticate and Get Access Token

All API endpoints are secured.
You must first call the get_access_token API to receive a Bearer Token, which is required to use any other endpoint.

Endpoint:
?action=get_access_token
Method: POST

Request Body

{
  "username": "your_username",
  "password": "your_password"
}

Success Response

{
  "success": true,
  "access_token": "your_generated_token"
}

Use this token in every further API request inside the header:

Authorization: Bearer your_generated_token
Content-Type: application/json

Step 4: Use EventPrime Endpoints

All endpoints below require a valid Bearer token from get_access_token. Include these headers on every request:
Authorization: Bearer your_generated_token · Content-Type: application/json
Base paths:
https://yourdomain.com/wp-json/eventprime/v1/integration (for most endpoints) · https://yourdomain.com/wp-json/eventprime/v2/integration (for create_event with advanced features).


1) Get All Events

Endpoint: ?action=get_events
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "count": 17,
  "events": [
    {
      "id": 20,
      "title": "Testing Event",
      "slug": "testing-event",
      "content": "",
      "status": "publish",
      "permalink": "http://api-integration.local/event/testing-event/",
      "thumbnail": null,
      "image_url": "",
      "start_date": "2025-10-06T00:00:00+00:00",
      "end_date": "2025-10-31T23:59:00+00:00",
      "timezone": null,
      "venue": null,
      "organizer": [],
      "performers": [],
      "event_types": [],
      "tickets": [
        { "id": 1, "name": "New Ticket", "price": 0, "capacity": 120 }
      ],
      "all_tickets_data": [
        {
          "id": "1",
          "event_id": "20",
          "name": "New Ticket",
          "price": "0.00",
          "capacity": "120"
        }
      ],
      "ticket_categories": [],
      "created_at": "2025-10-06 10:06:53",
      "updated_at": "2025-10-10 09:15:46"
    }
  ]
}

2) Get Single Event

Endpoint: ?action=get_event&id={event_id}
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "event": {
    "id": 357,
    "title": "Electronic Night 20251110142048",
    "slug": "electronic-night-20251110142048",
    "content": "An immersive music experience with live DJs and lighting effects.",
    "status": "publish",
    "permalink": "http://api-integration.local/event/electronic-night-20251110142048/",
    "thumbnail": null,
    "image_url": "",
    "start_date": "2026-07-10T20:00:00+00:00",
    "end_date": "2026-07-11T02:00:00+00:00",
    "timezone": null,
    "venue": { "id": 16, "name": "Skyline Arena" },
    "organizer": [{ "id": 15, "name": "Pulse Events" }],
    "performers": [
      { "id": 140, "name": "DJ Luna", "thumbnail": null },
      { "id": 141, "name": "Neon Drive", "thumbnail": null },
      { "id": 142, "name": "Bass Architect", "thumbnail": null }
    ],
    "event_types": [
      { "id": 5, "name": "Music" },
      { "id": 18, "name": "Festival" }
    ],
    "tickets": [
      { "id": 179, "name": "VIP Deck Ticket", "price": 25000, "capacity": 20 },
      { "id": 180, "name": "Gold Access", "price": 10000, "capacity": 60 },
      { "id": 181, "name": "Silver Entry", "price": 4500, "capacity": 220 }
    ],
    "ticket_categories": [
      { "id": 179, "event_id": 357, "name": "VIP Deck", "capacity": 20 },
      { "id": 180, "event_id": 357, "name": "Gold Zone", "capacity": 80 },
      { "id": 181, "event_id": 357, "name": "Silver Area", "capacity": 300 }
    ],
    "created_at": "2025-11-10 08:50:48",
    "updated_at": "2025-11-10 08:50:49"
  }
}

3) Create Event (Advanced with Tickets, Offers & Fees)

Endpoint: POST /wp-json/eventprime/v2/integration?action=create_event
Method: POST

Request Body

{
  "action": "create_event",
  "em_name": "Electronic Night 20251110142048",
  "em_start_date_time": "2026-07-10 20:00:00",
  "em_end_date_time": "2026-07-11 02:00:00",
  "em_description": "An immersive music experience with live DJs and lighting effects.",
  "organizer": "Pulse Events",
  "venue": "Skyline Arena",
  "performers": ["DJ Luna", "Neon Drive", "Bass Architect"],
  "event_types": ["Music", "Festival"],
  "em_timezone": "UTC",
  "em_enable_booking": "bookings_on",
  "tickets": [
    {
      "category_name": "VIP Deck",
      "category_capacity": 20,
      "name": "VIP Deck Ticket",
      "price": 25000,
      "quantity": 20,
      "special_price": 20000,
      "additional_fees": [
        { "name": "service_fee", "amount": 1500, "type": "fixed" },
        { "name": "processing", "amount": 2.5, "type": "percentage" }
      ],
      "offers": [
        {
          "em_ticket_offer_name": "Member Discount",
          "em_ticket_offer_description": "10% off for members",
          "em_ticket_offer_discount_type": "percentage",
          "em_ticket_offer_discount": 10,
          "em_ticket_offer_user_roles": ["members"],
          "em_offer_start_booking_type": "date",
          "em_offer_start_booking_date": "2026-05-01",
          "em_offer_start_booking_time": "00:00:00",
          "em_offer_ends_booking_type": "date",
          "em_offer_ends_booking_date": "2026-07-09",
          "em_offer_ends_booking_time": "23:59:59",
          "em_ticket_show_offer_detail": "1",
          "uid": "45934da0-316d-4c1b-8db3-789262d406e0"
        }
      ],
      "booking_starts": ["2026-05-01T00:00:00Z"],
      "booking_ends": ["2026-07-09T23:59:59Z"],
      "allow_cancellation": 1,
      "show_remaining_tickets": 1,
      "show_ticket_booking_dates": 1,
      "min_ticket_no": 1,
      "max_ticket_no": 4,
      "is_default": 1,
      "is_event_price": 0,
      "icon": "icon-vip",
      "priority": 1,
      "status": 1
    }
  ]
}

Success Response

{
  "status": "success",
  "count": 1,
  "event": {
    "id": 357,
    "name": "Electronic Night 20251110142048",
    "description": "An immersive music experience with live DJs and lighting effects.",
    "start_date": "2026-07-10T20:00:00+00:00",
    "end_date": "2026-07-11T02:00:00+00:00",
    "venue_id": 16,
    "organizer_id": 15,
    "performer_ids": [140, 141, 142],
    "event_type_ids": [5, 18],
    "tickets": [
      { "id": 179, "name": "VIP Deck Ticket" },
      { "id": 180, "name": "Gold Access" },
      { "id": 181, "name": "Silver Entry" }
    ]
  }
}

4) Get Tickets by Event

Endpoint: ?action=get_tickets&event_id={event_id}
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "count": 2,
  "tickets": [
    {
      "ticket_id": 186,
      "ticket_name": "General Admission",
      "price": 25,
      "capacity": 100,
      "event_id": 369,
      "meta": {
        "id": "186",
        "event_id": "369",
        "name": "General Admission",
        "description": "",
        "start_date": null,
        "end_date": null,
        "price": "25.00",
        "special_price": "",
        "capacity": "100",
        "is_default": "1",
        "is_event_price": "0",
        "icon": "",
        "priority": "1",
        "capacity_progress_bar": "0",
        "status": "1",
        "created_at": "2025-11-10 11:33:13",
        "updated_at": null,
        "variation_color": null,
        "seat_data": null,
        "parent_price_option_id": "0",
        "category_id": "0",
        "additional_fees": [
          {
            "label": "Service Fee",
            "price": 2.5,
            "description": "Online booking service fee",
            "type": "fixed"
          },
          {
            "label": "Processing Fee",
            "price": 1.5,
            "description": "Payment processing fee",
            "type": "fixed"
          }
        ],
        "allow_cancellation": "0",
        "show_remaining_tickets": "0",
        "show_ticket_booking_dates": "0",
        "min_ticket_no": "0",
        "max_ticket_no": "0",
        "visibility": "",
        "offers": [
          {
            "eligible": ["all"],
            "description": "10% off for early bookings",
            "name": "Early Bird Discount",
            "value": 10,
            "type": "percentage",
            "em_ticket_offer_discount_type": "percentage",
            "em_ticket_offer_discount": 10,
            "em_ticket_offer_user_roles": ["all"],
            "em_ticket_offer_name": "Early Bird Discount",
            "em_ticket_offer_description": "10% off for early bookings",
            "uid": "",
            "em_offer_start_booking_type": "",
            "em_offer_start_booking_date": "",
            "em_offer_start_booking_time": "",
            "em_offer_start_booking_days": "",
            "em_offer_start_booking_days_option": "",
            "em_offer_start_booking_event_option": "",
            "em_offer_ends_booking_type": "",
            "em_offer_ends_booking_date": "",
            "em_offer_ends_booking_time": "",
            "em_offer_ends_booking_days": "",
            "em_offer_ends_booking_days_option": "",
            "em_offer_ends_booking_event_option": "",
            "em_ticket_show_offer_detail": ""
          }
        ],
        "booking_starts": [],
        "booking_ends": [],
        "multiple_offers_option": "",
        "multiple_offers_max_discount": "",
        "ticket_template_id": "0"
      }
    }
  ]
}

5) Create Ticket

Endpoint: ?action=create_ticket
Method: POST

Request Body

{
  "event_id": 369,
  "category_name": "General Admission",
  "name": "General Admission",
  "price": 25.00,
  "quantity": 100,
  "category_capacity": 100,
  "additional_fees": [
    {
      "label": "Service Fee",
      "price": 2.5,
      "description": "Online booking service fee",
      "type": "fixed"
    },
    {
      "label": "Processing Fee",
      "price": 1.5,
      "description": "Payment processing fee",
      "type": "fixed"
    }
  ],
  "offers": [
    {
      "name": "Early Bird Discount",
      "type": "percentage",
      "value": 10,
      "eligible": ["all"],
      "description": "10% off for early bookings",
      "em_ticket_offer_name": "Early Bird Discount",
      "em_ticket_offer_description": "10% off for early bookings",
      "em_ticket_offer_discount_type": "percentage",
      "em_ticket_offer_discount": 10,
      "em_ticket_offer_user_roles": ["all"],
      "em_ticket_show_offer_detail": "1"
    }
  ],
  "allow_cancellation": 0,
  "show_remaining_tickets": 0,
  "show_ticket_booking_dates": 0,
  "min_ticket_no": 0,
  "max_ticket_no": 0
}

Success Response

{
  "status": "success",
  "count": 1,
  "ticket": { "id": 186 }
}

6) Get Performers

Endpoint: ?action=get_performers
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "count": 27,
  "performers": [
    {
      "id": 361,
      "name": "John Smith Band",
      "slug": "john-smith-band",
      "description": "Popular local band specializing in rock and pop covers",
      "performer_url": "http://api-integration.local/performers/?performer=361",
      "image_url": "http://api-integration.local/wp-content/plugins/EventPrime-core-eventprime-api-integration-final/public/partials/images/dummy-user.png",
      "em_type": "Band",
      "em_role": "Musician",
      "em_performer_emails": ["john@johnsmithband.com", "booking@johnsmithband.com"],
      "em_performer_phones": ["+91 9876543210"],
      "em_performer_websites": ["https://johnsmithband.com"],
      "em_social_links": {
        "facebook": "https://facebook.com/johnsmithband",
        "instagram": "https://instagram.com/johnsmithband"
      }
    }
  ]
}

7) Create Performer

Endpoint: POST /wp-json/eventprime/v1/integration
Method: POST

Request Body

{
  "action": "create_performer",
  "name": "John Smith Band",
  "description": "Popular local band specializing in rock and pop covers",
  "em_type": "Band",
  "em_role": "Musician",
  "em_performer_emails": ["john@johnsmithband.com", "booking@johnsmithband.com"],
  "em_performer_phones": ["+91 9876543210"],
  "em_performer_websites": ["https://johnsmithband.com"],
  "em_social_links": {
    "facebook": "https://facebook.com/johnsmithband",
    "instagram": "https://instagram.com/johnsmithband"
  }
}

Success Response

{
  "status": "success",
  "count": 1,
  "performer": {
    "id": 362,
    "name": "John Smith Band",
    "slug": "john-smith-band-2",
    "description": "Popular local band specializing in rock and pop covers",
    "performer_url": "http://api-integration.local/performers/?performer=362",
    "image_url": "http://api-integration.local/wp-content/plugins/EventPrime-core-eventprime-api-integration-final/public/partials/images/dummy-user.png",
    "em_type": "Band",
    "em_role": "Musician",
    "em_performer_emails": ["john@johnsmithband.com", "booking@johnsmithband.com"],
    "em_performer_phones": ["+91 9876543210"],
    "em_performer_websites": ["https://johnsmithband.com"],
    "em_social_links": {
      "facebook": "https://facebook.com/johnsmithband",
      "instagram": "https://instagram.com/johnsmithband"
    }
  }
}

8) Get Venues

Endpoint: ?action=get_venues
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "count": 10,
  "venues": [
    {
      "id": 42,
      "name": "Grand Convention Center",
      "slug": "grand-convention-center",
      "description": "",
      "venue_url": "http://api-integration.local/venues/?venue=42",
      "image_url": "http://api-integration.local/wp-content/plugins/EventPrime-core-eventprime-api-integration-final/admin/partials/images/dummy_image.png",
      "em_address": "123 Event Street, Downtown",
      "em_locality": "City Center",
      "em_state": "State",
      "em_country": "Country",
      "em_postal_code": "100001",
      "other_image_url": []
    }
  ]
}

9) Create Venue

Endpoint: POST /wp-json/eventprime/v1/integration
Method: POST

Request Body

{
  "action": "create_venue",
  "name": "Grand Convention Center",
  "description": "A spacious venue perfect for large events and conferences",
  "em_address": "123 Event Street, Downtown",
  "em_locality": "City Center",
  "em_state": "State",
  "em_country": "Country",
  "em_postal_code": "100001"
}

Success Response

{
  "status": "success",
  "count": 1,
  "venue": {
    "id": 42,
    "name": "Grand Convention Center",
    "slug": "grand-convention-center",
    "description": "",
    "venue_url": "http://api-integration.local/venues/?venue=42",
    "image_url": "http://api-integration.local/wp-content/plugins/EventPrime-core-eventprime-api-integration-final/admin/partials/images/dummy_image.png",
    "em_address": "123 Event Street, Downtown",
    "em_locality": "City Center",
    "em_state": "State",
    "em_country": "Country",
    "em_postal_code": "100001"
  }
}

10) Get Organizers

Endpoint: ?action=get_organizers
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "count": 10,
  "organizers": [
    {
      "id": 40,
      "name": "Celestial Event Planners",
      "slug": "celestial-event-planners",
      "description": "Premium event planning and management services",
      "organizer_url": "https://api-integration.local/event-organizers/?organizer=40",
      "image_url": "https://api-integration.local/wp-content/plugins/EventPrime-core-eventprime-api-integration-final/public/partials/images/dummy-user.png",
      "em_organizer_emails": ["contact@celestialevents.in"],
      "em_organizer_phones": ["+91 9988776655"],
      "em_organizer_websites": ["https://celestialevents.in"]
    }
  ]
}

11) Create Organizer

Endpoint: POST /wp-json/eventprime/v1/integration
Method: POST

Request Body

{
  "action": "create_organizer",
  "name": "Celestial Event Planners",
  "description": "Premium event planning and management services",
  "em_organizer_emails": ["contact@celestialevents.in"],
  "em_organizer_phones": ["+91 9988776655"],
  "em_organizer_websites": ["https://celestialevents.in"]
}

Success Response

{
  "status": "success",
  "count": 1,
  "organizer": {
    "id": 40,
    "name": "Celestial Event Planners",
    "slug": "celestial-event-planners",
    "description": "Premium event planning and management services",
    "organizer_url": "http://api-integration.local/event-organizers/?organizer=40",
    "image_url": "http://api-integration.local/wp-content/plugins/EventPrime-core-eventprime-api-integration-final/public/partials/images/dummy-user.png",
    "em_organizer_emails": ["contact@celestialevents.in"],
    "em_organizer_phones": ["+91 9988776655"],
    "em_organizer_websites": ["https://celestialevents.in"]
  }
}

12) Get Event Types

Endpoint: ?action=get_event_types
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "count": 22,
  "event_types": [
    {
      "id": 43,
      "name": "Music Concert",
      "slug": "music-concert",
      "description": "Live music performances and concerts",
      "event_type_url": "http://api-integration.local/event-types/?event_type=43",
      "image_url": "http://api-integration.local/wp-content/plugins/EventPrime-core-eventprime-api-integration-final/admin/partials/images/dummy_image.png",
      "em_color": "#FF5733",
      "em_type_text_color": "#FFFFFF",
      "age_group": "all"
    }
  ]
}

13) Create Event Type

Endpoint: POST /wp-json/eventprime/v1/integration
Method: POST

Request Body

{
  "action": "create_event_type",
  "name": "Music Concert",
  "description": "Live music performances and concerts",
  "em_color": "#FF5733",
  "em_type_text_color": "#FFFFFF"
}

Success Response

{
  "status": "success",
  "count": 1,
  "event_type": {
    "id": 43,
    "name": "Music Concert",
    "slug": "music-concert",
    "description": "Live music performances and concerts",
    "event_type_url": "http://api-integration.local/event-types/?event_type=43",
    "image_url": "http://api-integration.local/wp-content/plugins/EventPrime-core-eventprime-api-integration-final/admin/partials/images/dummy_image.png",
    "em_color": "#FF5733",
    "em_type_text_color": "#FFFFFF",
    "age_group": "all"
  }
}

14) Get Bookings

Endpoint: ?action=get_bookings
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "count": 2,
  "bookings": [
    {
      "em_id": "90",
      "em_event": "87",
      "em_date": "1760002092",
      "em_user": "1",
      "em_name": "API Test Event With Tickets",
      "em_status": "completed",
      "em_payment_method": "paypal",
      "em_random_order_id": "6lydj",
      "em_order_info": {
        "tickets": [
          {
            "id": 31,
            "category_id": "29",
            "name": "VIP",
            "price": 100,
            "qty": 1,
            "offer": 0,
            "additional_fee": [],
            "subtotal": 100
          },
          {
            "id": 32,
            "category_id": "30",
            "name": "GA",
            "price": 20,
            "qty": 2,
            "offer": 0,
            "additional_fee": [],
            "subtotal": 40
          }
        ],
        "event_fixed_price": 0,
        "booking_total": 140,
        "payment_gateway": "paypal"
      },
      "em_payment_log": {
        "payment_gateway": "paypal",
        "payment_status": "completed",
        "total_amount": "140.00",
        "currency": "USD"
      },
      "em_attendee_names": {
        "31": {
          "1": { "name": { "first_name": "hero", "last_name": "1" } }
        },
        "32": {
          "1": { "name": { "first_name": "hero", "last_name": "2" } },
          "2": { "name": { "first_name": "hero", "last_name": "3" } }
        }
      },
      "booking_detail_url": "http://api-integration.local/booking-details/?order_id=90"
    }
  ]
}

15) Get Booking by Id

Endpoint: ?action=get_bookings&id={booking_id}
Method: GET
Request Body: Not required

Success Response

{
  "status": "success",
  "count": 1,
  "bookings": [
    {
      "em_id": "90",
      "em_event": "87",
      "em_date": "1760002092",
      "em_user": "1",
      "em_name": "API Test Event With Tickets",
      "em_status": "completed",
      "em_payment_method": "paypal",
      "em_random_order_id": "6lydj",
      "em_order_info": {
        "tickets": [
          {
            "id": 31,
            "category_id": "29",
            "name": "VIP",
            "price": 100,
            "qty": 1,
            "offer": 0,
            "additional_fee": [],
            "subtotal": 100
          },
          {
            "id": 32,
            "category_id": "30",
            "name": "GA",
            "price": 20,
            "qty": 2,
            "offer": 0,
            "additional_fee": [],
            "subtotal": 40
          }
        ],
        "event_fixed_price": 0,
        "booking_total": 140,
        "payment_gateway": "paypal"
      },
      "em_payment_log": {
        "payment_gateway": "paypal",
        "payment_status": "completed",
        "total_amount": "140.00",
        "currency": "USD"
      },
      "em_attendee_names": {
        "31": {
          "1": { "name": { "first_name": "hero", "last_name": "1" } }
        },
        "32": {
          "1": { "name": { "first_name": "hero", "last_name": "2" } },
          "2": { "name": { "first_name": "hero", "last_name": "3" } }
        }
      },
      "booking_detail_url": "http://api-integration.local/booking-details/?order_id=90"
    }
  ]
}

Conclusion

The EventPrime REST API gives developers and site owners a simple way to integrate WordPress event data from EventPrime with any external application.

Questions, Support & Custom Solutions

  • Need more details or can't find what you're looking for? Let us know how we can help! Contact our support team here.
  • Looking for a tailor-made solution to meet your specific needs? Our dedicated customization team is here to help! Use this link to share your requirements with us, and we'll collaborate with you to bring your vision to life.

Leave a Reply

Your email address will not be published. Required fields are marked *