EventPrime API documentation - EventPrime

Our best plan is on SALE right now!

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"
    }
  ]
}

Control Who Can Use Each Endpoint

Every route, action and trigger has its own role mapping under EventPrime > Settings > API / Webhooks > REST Access Policies. A request is allowed only after authentication, and only when the user’s role is selected in that row’s Allowed Roles. Use Filter APIs to find a row by its target, such as action=create_booking.

EventPrime REST Access Policies table filtered to create_booking
REST Access Policies filtered to create_booking

AI Abilities (Abilities API / MCP)

EventPrime also registers its features with the WordPress Abilities API, so AI assistants and MCP clients can use them. Turn this on or off with Enable AI Abilities on the same tab. Abilities that change data, or that read bookings and attendees, follow the same REST Access Policies as the matching API actions. Learn how to control EventPrime AI abilities.

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.
Subscribe
Notify of
guest

0 Comments
0
Would love your thoughts, please comment.x