Eventzilla

Eventzilla API (v2)

Download OpenAPI specification:

API reference

Eventzilla API provides a predictable, resource-oriented way to integrate with Eventzilla and extend it for your event management workflows. API methods use JSON request and response bodies, and responses are returned in JSON format.

Version 2 introduces the core capabilities needed to retrieve Eventzilla account data, prepare and process registrations, confirm or cancel orders, and check in attendees.

To create an API key, sign in to Eventzilla and go to Settings > Developers > API Credentials.

Generate API key

Authentication

Eventzilla uses an x-api-key header for authentication. Generate an API key by creating an application under Settings > Developers > API Credentials in your Eventzilla account. Keep API keys secret, rotate them when needed, and disable keys that are no longer in use.

All API requests must be sent over HTTPS.

x-api-key: 565e95b08ad5210001000001bf8fe9787f6f4c674f2fd622844adf23

Filtering

Many list endpoints support filtering by passing returned resource fields as query-string parameters. For example, events can be filtered by status and category.

https://www.eventzillaapi.net/api/v2/events?status=live
https://www.eventzillaapi.net/api/v2/events?status=live&category=music
https://www.eventzillaapi.net/api/v2/events?status=live&offset=0&limit=20&category=music

Paging

Endpoints that return multiple records support paging to keep responses fast and predictable.

https://www.eventzillaapi.net/api/v2/events?offset=1&limit=2
Parameter Type Default Description
offset integer 0 Number of records to skip before returning results.
limit integer 20 Maximum number of records to return.

Errors and response codes

The API uses standard HTTP response codes. A successful request normally returns 200 OK; resource creation may return 201 Created; invalid input may return 400 Bad Request; missing or invalid API keys may return 401 Unauthorized; and a missing resource may return 404 Not Found.

Backwards compatibility

Public endpoints and public response fields should remain backwards compatible. When a clearer field name is introduced, the existing field should continue to be accepted or returned during a deprecation period. New, unreleased endpoints can use the cleaner names directly before they are made public.

Webhooks

Webhook documentation is available on a separate page: View webhook documentation.

Events

Retrieve events and event-related data for your account.

List events

Returns events in the authenticated Eventzilla account.

query Parameters
status
string

Filter by event status, such as live, draft, unpublished, or completed.

category
string

Filter by category name.

offset
integer
Default: 0

Number of records to skip.

limit
integer
Default: 20

Maximum number of records to return.

Responses

Response Schema: application/json
Array of objects (Pagination)
Array
offset
integer

Records skipped before returning this page.

limit
integer

Maximum records returned in this page.

total
integer

Total records available for this request.

Array of objects (Event)
Array
id
integer

Unique event identifier.

title
string

Event title.

description
string

Plain-text or escaped HTML event description.

currency
string

Currency used for the event.

start_date
string <date-time>

Start date for the event occurrence.

start_time
string

Local event start time.

end_date
string <date-time>

End date for the event occurrence.

end_time
string

Local event end time.

dateid
integer

Unique identifier for the event date/occurrence.

time_zone
string

Time zone in which the event occurs.

tickets_sold
integer

Number of tickets sold so far.

tickets_total
integer

Total ticket capacity for the event.

status
string
Enum: "Live" "Draft" "Unpublished" "Completed"

Event status.

show_remaining
boolean

Whether the event page displays remaining ticket quantities.

twitter_hashtag
string

Hashtag used for social sharing, if configured.

utc_offset
string

UTC offset for the event time zone, such as +00:00.

invite_code
string

Invite code for restricted event access, if applicable.

url
string <uri>

Public event URL.

logo_url
string

URL of the event logo image, if uploaded.

bgimage_url
string

URL of the event background image, if uploaded.

venue
string

Event venue or location details.

categories
string

Comma-separated event category names.

language
string

Event language code.

description_html
string

Full event description as HTML.

timezone_code
string

Time zone abbreviation/code.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "pagination": [
    • {
      • "offset": 0,
      • "limit": 20,
      • "total": 1
      }
    ],
  • "events": []
}

Get event details

path Parameters
eventid
required
integer

Event identifier.

Responses

Response Schema: application/json
Array of objects (Event)
Array
id
integer

Unique event identifier.

title
string

Event title.

description
string

Plain-text or escaped HTML event description.

currency
string

Currency used for the event.

start_date
string <date-time>

Start date for the event occurrence.

start_time
string

Local event start time.

end_date
string <date-time>

End date for the event occurrence.

end_time
string

Local event end time.

dateid
integer

Unique identifier for the event date/occurrence.

time_zone
string

Time zone in which the event occurs.

tickets_sold
integer

Number of tickets sold so far.

tickets_total
integer

Total ticket capacity for the event.

status
string
Enum: "Live" "Draft" "Unpublished" "Completed"

Event status.

show_remaining
boolean

Whether the event page displays remaining ticket quantities.

twitter_hashtag
string

Hashtag used for social sharing, if configured.

utc_offset
string

UTC offset for the event time zone, such as +00:00.

invite_code
string

Invite code for restricted event access, if applicable.

url
string <uri>

Public event URL.

logo_url
string

URL of the event logo image, if uploaded.

bgimage_url
string

URL of the event background image, if uploaded.

venue
string

Event venue or location details.

categories
string

Comma-separated event category names.

language
string

Event language code.

description_html
string

Full event description as HTML.

timezone_code
string

Time zone abbreviation/code.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{}

List event transactions

path Parameters
eventid
required
integer

Event identifier.

query Parameters
offset
integer
Default: 0

Number of records to skip.

limit
integer
Default: 20

Maximum number of records to return.

Responses

Response Schema: application/json
Array of objects (Pagination)
Array
offset
integer

Records skipped before returning this page.

limit
integer

Maximum records returned in this page.

total
integer

Total records available for this request.

Array of objects (EventTransaction)
Array
transaction_ref
string

Order reference for this transaction.

checkout_id
integer

Checkout identifier.

transaction_date
string <date-time>

Transaction timestamp.

number or string (FlexibleNumber)
One of
number
tickets_in_transaction
integer

Number of tickets/attendees in the transaction.

event_date
string <date-time>

Event date associated with the transaction.

transaction_status
string

Transaction status.

user_id
integer

Buyer user identifier.

buyer_id
integer

Buyer identifier; used in some transaction documentation.

event_id
integer

Event identifier.

title
string

Event title.

email
string <email>

Buyer email address.

buyer_first_name
string

Buyer first name.

buyer_last_name
string

Buyer last name.

promo_code
string

Promo/discount code, if used.

payment_type
string

Payment method.

comments
string

Transaction comments or notes.

number or string (FlexibleNumber)
One of
number
number or string (FlexibleNumber)
One of
number
number or string (FlexibleNumber)
One of
number
refno
string

Order reference number used by transaction lookup endpoints.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "pagination": [
    • {
      • "offset": 0,
      • "limit": 20,
      • "total": 1
      }
    ],
  • "transactions": [
    • {
      • "transaction_ref": "20260520145-178028",
      • "checkout_id": 2138868785,
      • "transaction_date": "2026-05-20T14:20:20",
      • "transaction_amount": 198,
      • "tickets_in_transaction": 2,
      • "event_date": "2026-05-20T09:00:00",
      • "transaction_status": "Confirmed",
      • "user_id": 42628,
      • "event_id": 2138988852,
      • "title": "Chicago SaaS Growth Summit",
      • "email": "amelia.chen@example.com",
      • "buyer_first_name": "Amelia",
      • "buyer_last_name": "Chen",
      • "promo_code": "",
      • "payment_type": "Card",
      • "comments": "",
      • "transaction_tax": 18,
      • "transaction_discount": 0,
      • "eventzilla_fee": 5.63
      }
    ]
}

List event attendees

path Parameters
eventid
required
integer

Event identifier.

Responses

Response Schema: application/json
Array of objects (Attendee)
Array
first_name
string

Attendee first name.

last_name
string

Attendee last name.

ticket_type
string

Ticket/registration type registered by this attendee.

bar_code
string

Unique barcode associated with this attendee.

is_attended
string

Check-in/attendance status.

transaction_ref
string

Order reference for this transaction.

refno
string

Order reference number used by attendee lookup endpoints.

Array of objects (QuestionAnswer)

Registration question answers.

Array
questionid
integer

Question identifier, if returned.

questions
string

Question text.

answer
string

Answer text.

id
integer

Transaction or attendee-related identifier returned by the endpoint.

transaction_date
string <date-time>

Transaction timestamp.

number or string (FlexibleNumber)
One of
number
event_date
string <date-time>

Event date associated with this attendee.

transaction_status
string

Transaction status.

user_id
integer

Buyer/user identifier.

event_id
integer

Event identifier.

title
string

Event title.

email
string <email>

Buyer email address.

buyer_first_name
string

Buyer first name.

buyer_last_name
string

Buyer last name.

promo_code
string

Promo/discount code, if used.

payment_type
string

Payment method.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "attendees": [
    • {
      • "first_name": "Amelia",
      • "last_name": "Chen",
      • "ticket_type": "Early bird admission",
      • "bar_code": "EZ202605200001",
      • "is_attended": "No",
      • "questions": [
        • {
          • "questions": "Company",
          • "answer": "Northstar SaaS"
          }
        ],
      • "transaction_ref": "20260520145-178028",
      • "id": 2139049165,
      • "transaction_date": "2026-05-01T10:15:00",
      • "transaction_amount": 99,
      • "event_date": "2026-05-20T09:00:00",
      • "transaction_status": "Confirmed",
      • "user_id": 42628,
      • "event_id": 2138988852,
      • "title": "Chicago SaaS Growth Summit",
      • "email": "amelia.chen@example.com",
      • "buyer_first_name": "Amelia",
      • "buyer_last_name": "Chen",
      • "promo_code": "",
      • "payment_type": "Card"
      }
    ]
}

Toggle event sales

Sales on/off notifications

Request Body schema: application/json
required
eventid
required
integer

Event identifier.

status
required
boolean

true to publish sales, false to unpublish sales.

Responses

Response Schema: application/json
eventstatus
string

Resulting event sales status.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "eventid": 2138988852,
  • "status": true
}

Response samples

Content type
application/json
{
  • "eventstatus": "published"
}

Event ticket types

Manage ticket types and pricing for an event.

List event ticket types

Returns the ticket types available for the specified event. This public route remains /events/{eventid}/tickets for backwards compatibility, although the resource is documented as ticket types.

path Parameters
eventid
required
integer

Event identifier.

Responses

Response Schema: application/json
Array of objects (EventTicketType)

Ticket types/categories for the event.

Array
id
integer

Unique identifier for the ticket type/category.

title
string

Ticket type/category title.

quantity_total
integer

Total quantity available for this ticket type.

number or string (FlexibleNumber)
One of
number
description
string

Full description of the ticket type.

sales_start_date
string <date-time>

Sales start date.

sales_start_time
string

Sales start time.

sales_end_date
string <date-time>

Sales end date.

sales_end_time
string

Sales end time.

number or string (FlexibleNumber)
One of
number
number or string (FlexibleNumber)
One of
number
number or string (FlexibleNumber)
One of
number
additional_instructions
string

Additional instructions shown to attendees.

unlock_code
string

Unlock code for restricted ticket access, if applicable.

ticket_type
string

Ticket type/category label, such as Paid, Free, Add-on, Donation, or Approval.

tickets
string
Deprecated

Historical documentation name for the ticket type/category. Prefer ticket_type when present.

is_visible
boolean

Whether this ticket type is visible on the event registration page.

isvisible
boolean
Deprecated

Historical documentation name for is_visible. Retained for documentation compatibility.

boolean or string (FlexibleBoolean)
One of
boolean
boolean or string (FlexibleBoolean)
One of
boolean
limit_minimum
integer

Minimum quantity allowed per order.

limit_maximum
integer

Maximum quantity allowed per order.

partial_payment_installments
integer

Number of partial-payment instalments, if enabled.

partial_payment_frequency
string

Partial-payment frequency, such as Monthly or Weekly.

number or string (FlexibleNumber)
One of
number
Array of objects (DonationTicket)

Donation ticket options for the event, if any.

Array
donationid
integer

Unique identifier for the donation ticket option.

title
string

Donation ticket title.

description
string

Donation ticket description.

quantity_total
integer

Total donation ticket quantity available.

number or string (FlexibleNumber)
One of
number
donation_start_date
string <date-time>

Donation availability start date.

donation_end_date
string <date-time>

Donation availability end date.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "tickets": [
    • {
      • "id": 2138120411,
      • "title": "Early bird admission",
      • "quantity_total": 150,
      • "price": 99,
      • "description": "Discounted admission for early registrations.",
      • "sales_start_date": "2026-02-05T00:00:00",
      • "sales_start_time": "09:00",
      • "sales_end_date": "2026-04-20T00:00:00",
      • "sales_end_time": "23:00",
      • "group_discount": 0,
      • "group_percentage": 0,
      • "group_price": 0,
      • "additional_instructions": "Please bring a valid photo ID for check-in.",
      • "unlock_code": "",
      • "ticket_type": "Paid",
      • "boxoffice_only": false,
      • "is_visible": true,
      • "limit_minimum": 1,
      • "limit_maximum": 10,
      • "allow_partial_payment": false,
      • "partial_payment_installments": 0,
      • "partial_payment_frequency": "",
      • "partial_payment_amount": 0
      }
    ],
  • "donation": [ ]
}

Create free ticket type

Creates a free ticket type for the specified event. This endpoint is new and should be published under /events/{eventid}/ticket-types rather than the older draft /events/{eventid}/tickets path, which is ambiguous with issued tickets and orders.

path Parameters
eventid
required
integer

Event identifier.

Request Body schema: application/json
required
ticket_type_name
required
string

Name displayed for this ticket type, such as Early bird admission.

quantity_total
required
integer

Total quantity available for this ticket type.

ticket_type_description
required
string

Public description shown to attendees for this ticket type.

sales_start_date
required
string

Date when sales open for this ticket type. Use the date format supported by the API implementation. Prefer ISO 8601 (2026-02-05) for new implementations.

sales_end_date
required
string

Date when sales close for this ticket type. Prefer ISO 8601 (2026-04-20) for new implementations.

sales_start_time
required
string

Time when sales open for this ticket type.

sales_end_time
required
string

Time when sales close for this ticket type.

limit_minimum
required
integer

Minimum quantity that can be selected in one order.

limit_maximum
required
integer

Maximum quantity that can be selected in one order.

is_visible
required
boolean

Whether this ticket type is visible on the event registration page.

boxoffice_only
required
boolean

Whether this ticket type is available only through box office sales.

additional_instructions
string

Additional instructions shown to attendees after registration or on their ticket.

unlock_code
string

Optional code required to unlock a restricted ticket type.

Responses

Response Schema: application/json
ticket_type_id
integer

Unique identifier for the ticket type.

ticket_type_name
string

Name displayed for this ticket type.

quantity_total
integer

Total quantity available for this ticket type.

ticket_type_description
string

Public description shown to attendees for this ticket type.

sales_start_date
string <date-time>

Date and time when sales open for this ticket type.

sales_start_time
string

Time when sales open for this ticket type.

sales_end_date
string <date-time>

Date and time when sales close for this ticket type.

sales_end_time
string

Time when sales close for this ticket type.

additional_instructions
string

Additional instructions shown to attendees.

unlock_code
string

Optional code required to unlock a restricted ticket type.

boxoffice_only
boolean

Whether this ticket type is available only through box office sales.

is_visible
boolean

Whether this ticket type is visible on the event registration page.

limit_minimum
integer

Minimum quantity that can be selected in one order.

limit_maximum
integer

Maximum quantity that can be selected in one order.

Response Schema: application/json
ticket_type_id
integer

Unique identifier for the ticket type.

ticket_type_name
string

Name displayed for this ticket type.

quantity_total
integer

Total quantity available for this ticket type.

ticket_type_description
string

Public description shown to attendees for this ticket type.

sales_start_date
string <date-time>

Date and time when sales open for this ticket type.

sales_start_time
string

Time when sales open for this ticket type.

sales_end_date
string <date-time>

Date and time when sales close for this ticket type.

sales_end_time
string

Time when sales close for this ticket type.

additional_instructions
string

Additional instructions shown to attendees.

unlock_code
string

Optional code required to unlock a restricted ticket type.

boxoffice_only
boolean

Whether this ticket type is available only through box office sales.

is_visible
boolean

Whether this ticket type is visible on the event registration page.

limit_minimum
integer

Minimum quantity that can be selected in one order.

limit_maximum
integer

Maximum quantity that can be selected in one order.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "ticket_type_name": "Early bird admission",
  • "quantity_total": 150,
  • "ticket_type_description": "Discounted admission for early registrations.",
  • "sales_start_date": "2026-02-05",
  • "sales_start_time": "09:00",
  • "sales_end_date": "2026-04-20",
  • "sales_end_time": "23:00",
  • "limit_minimum": 1,
  • "limit_maximum": 10,
  • "additional_instructions": "Please bring a valid photo ID for check-in.",
  • "is_visible": true,
  • "boxoffice_only": false,
  • "unlock_code": ""
}

Response samples

Content type
application/json
{
  • "ticket_type_id": 2138120411,
  • "ticket_type_name": "Early bird admission",
  • "quantity_total": 150,
  • "ticket_type_description": "Discounted admission for early registrations.",
  • "sales_start_date": "2026-02-05T00:00:00",
  • "sales_start_time": "09:00",
  • "sales_end_date": "2026-04-20T00:00:00",
  • "sales_end_time": "23:00",
  • "additional_instructions": "Please bring a valid photo ID for check-in.",
  • "unlock_code": "",
  • "boxoffice_only": false,
  • "is_visible": true,
  • "limit_minimum": 1,
  • "limit_maximum": 10
}

Update free ticket type

Updates an existing free ticket type. This endpoint is new and should use ticket_type_id in the route. Use PUT instead of PATCH only if the API requires all ticket type fields to be supplied on every update.

path Parameters
eventid
required
integer

Event identifier.

ticket_type_id
required
integer

Ticket type identifier.

Request Body schema: application/json
required
ticket_type_name
required
string

Name displayed for this ticket type, such as Early bird admission.

quantity_total
required
integer

Total quantity available for this ticket type.

ticket_type_description
required
string

Public description shown to attendees for this ticket type.

sales_start_date
required
string

Date when sales open for this ticket type. Use the date format supported by the API implementation. Prefer ISO 8601 (2026-02-05) for new implementations.

sales_end_date
required
string

Date when sales close for this ticket type. Prefer ISO 8601 (2026-04-20) for new implementations.

sales_start_time
required
string

Time when sales open for this ticket type.

sales_end_time
required
string

Time when sales close for this ticket type.

limit_minimum
required
integer

Minimum quantity that can be selected in one order.

limit_maximum
required
integer

Maximum quantity that can be selected in one order.

is_visible
required
boolean

Whether this ticket type is visible on the event registration page.

boxoffice_only
required
boolean

Whether this ticket type is available only through box office sales.

additional_instructions
string

Additional instructions shown to attendees after registration or on their ticket.

unlock_code
string

Optional code required to unlock a restricted ticket type.

Responses

Response Schema: application/json
ticket_type_id
integer

Unique identifier for the ticket type.

ticket_type_name
string

Name displayed for this ticket type.

quantity_total
integer

Total quantity available for this ticket type.

ticket_type_description
string

Public description shown to attendees for this ticket type.

sales_start_date
string <date-time>

Date and time when sales open for this ticket type.

sales_start_time
string

Time when sales open for this ticket type.

sales_end_date
string <date-time>

Date and time when sales close for this ticket type.

sales_end_time
string

Time when sales close for this ticket type.

additional_instructions
string

Additional instructions shown to attendees.

unlock_code
string

Optional code required to unlock a restricted ticket type.

boxoffice_only
boolean

Whether this ticket type is available only through box office sales.

is_visible
boolean

Whether this ticket type is visible on the event registration page.

limit_minimum
integer

Minimum quantity that can be selected in one order.

limit_maximum
integer

Maximum quantity that can be selected in one order.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "ticket_type_name": "Early bird admission",
  • "quantity_total": 200,
  • "ticket_type_description": "Discounted admission for early registrations.",
  • "sales_start_date": "2026-02-05",
  • "sales_start_time": "09:00",
  • "sales_end_date": "2026-04-20",
  • "sales_end_time": "23:00",
  • "limit_minimum": 1,
  • "limit_maximum": 10,
  • "additional_instructions": "Please bring a valid photo ID for check-in.",
  • "is_visible": true,
  • "boxoffice_only": false,
  • "unlock_code": ""
}

Response samples

Content type
application/json
{
  • "ticket_type_id": 2138120411,
  • "ticket_type_name": "Early bird admission",
  • "quantity_total": 200,
  • "ticket_type_description": "Discounted admission for early registrations.",
  • "sales_start_date": "2026-02-05T00:00:00",
  • "sales_start_time": "09:00",
  • "sales_end_date": "2026-04-20T00:00:00",
  • "sales_end_time": "23:00",
  • "additional_instructions": "Please bring a valid photo ID for check-in.",
  • "unlock_code": "",
  • "boxoffice_only": false,
  • "is_visible": true,
  • "limit_minimum": 1,
  • "limit_maximum": 10
}

Event categories

Look up categories used to classify and filter events.

List event categories

Returns the available event categories for the authenticated account.

Responses

Response Schema: application/json
Array of objects (Category)
Array
category
string

Event category name, such as Business, Conferences, Networking, or Training.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "categories": [
    • {
      • "category": "Business"
      },
    • {
      • "category": "Conferences"
      },
    • {
      • "category": "Networking"
      },
    • {
      • "category": "Training"
      }
    ]
}

Event orders

Confirm or cancel event orders after checkout.

Cancel event order

Get Events by associated Client

Request Body schema: application/json
required
checkout_id
required
integer

Checkout identifier.

eventid
required
integer

Event identifier.

comments
required
string

Organizer comments for cancellation.

Responses

Response Schema: application/json
ordercancel
string

Order cancellation status message.

orderconfirm
string
Deprecated

Historical documentation typo for cancellation response. Prefer ordercancel.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "checkout_id": 21388601015,
  • "eventid": 2138988852,
  • "comments": "Cancelled at buyer request."
}

Response samples

Content type
application/json
{
  • "ordercancel": "success"
}

Confirm event order

Get Events by associated Client

Request Body schema: application/json
required
checkout_id
required
integer

Checkout identifier.

eventid
required
integer

Event identifier.

comments
required
string

Organizer comments for the order action.

sendemail
boolean
Default: true

Whether to send notification emails.

Responses

Response Schema: application/json
orderconfirm
string

Order confirmation status message.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "checkout_id": 21388601015,
  • "eventid": 2138988852,
  • "comments": "Confirmed by organizer.",
  • "sendemail": false
}

Response samples

Content type
application/json
{
  • "orderconfirm": "success"
}

Checkout

Prepare, create, fill, and confirm registration checkout flows.

Prepare checkout

Get events by assoiciated clients (Completed events)

path Parameters
eventid
required
integer

Event identifier.

dateid
required
integer

Event date/occurrence identifier.

Responses

Response Schema: application/json
Array of objects (PaymentOption)
Array
payment_id
integer

Payment option identifier.

paymentoption_name
string

Payment option name.

Array of objects (CheckoutTicketType)

Ticket types available for checkout. Public field name retained as tickettypes.

Array
ticket_type_id
integer

Ticket type identifier.

ticket_type_name
string

Ticket type name.

number or string (FlexibleNumber)
One of
number
ticket_type_min_limit
integer

Minimum quantity per order.

ticket_type_max_limit
integer

Maximum quantity per order.

ticket_type_avail_quantity
integer

Quantity currently available.

ticket_type_onsale
boolean

Whether this ticket type is currently on sale.

ticket_type_description
string

Ticket type description.

Array of objects (CheckoutQuestion)
Array
question_id
integer

Question identifier.

question_type
string

Question type code.

question_text
string

Question text.

question_choices
Array of strings

Available answer choices.

question_choice
Array of strings

Historical singular form used in examples; prefer question_choices.

question_waiver
string

Waiver text, if applicable.

has_subquestion
boolean

Whether the question has conditional subquestions.

Array of objects

Conditional subquestion mapping rules.

Array
question_id
integer
mapped_choice
Array of strings
discount_enabled
boolean
tax_enabled
boolean
Array of objects (Tax)
Array
tax_type
string

Tax type, such as inclusive.

tax_name
string

Tax name.

tax_value
string

Tax rate/value.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "payment_options": [
    • {
      • "payment_id": 2138979179,
      • "paymentoption_name": "stripe"
      },
    • {
      • "payment_id": 2138979165,
      • "paymentoption_name": "Free ticket only"
      }
    ],
  • "tickettypes": [
    • {
      • "ticket_type_id": 2138120411,
      • "ticket_type_name": "Early bird admission",
      • "ticket_type_price": "USD 99.00",
      • "ticket_type_min_limit": 1,
      • "ticket_type_max_limit": 10,
      • "ticket_type_avail_quantity": 102,
      • "ticket_type_onsale": true,
      • "ticket_type_description": "Discounted admission for early registrations."
      }
    ],
  • "questions": [
    • {
      • "question_id": 2138360281,
      • "question_type": "txt",
      • "question_text": "Company",
      • "question_choices": [ ],
      • "question_waiver": "",
      • "has_subquestion": false,
      • "subquestion_rules": [ ]
      }
    ],
  • "discount_enabled": true,
  • "tax_enabled": true,
  • "tax": [
    • {
      • "tax_type": "inclusive",
      • "tax_name": "GST",
      • "tax_value": "10%"
      }
    ]
}

Create checkout order

Request Body schema: application/json
required
eventid
required
integer

Event identifier.

eventdateid
required
integer

Event date/occurrence identifier.

required
Array of objects (CheckoutCreateTicketTypeRequest)

Ticket types and quantities to reserve.

Array
ticket_type_id
required
integer

Ticket type identifier.

quantity
required
integer

Quantity requested.

discount_code
string

Discount code, if any.

Responses

Response Schema: application/json
checkout_id
integer

Checkout identifier.

transaction_ref
string

Transaction reference.

transaction_total
number

Transaction total.

transaction_tax
number

Tax amount.

transaction_discount
number

Discount amount.

transaction_status
string

Transaction status.

eventzilla_fee
number

Eventzilla fee.

Array of objects (CheckoutCreatedTicket)
Array
ticket_price_id
integer

Generated ticket price/item identifier.

ticket_type_id
integer

Ticket type identifier.

ticket_type_name
string

Ticket type name.

currency
string

Currency symbol or code.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "eventid": 2138988852,
  • "eventdateid": 2138985706,
  • "ticket_types": [
    • {
      • "ticket_type_id": 2138120411,
      • "quantity": 2
      }
    ],
  • "discount_code": "SAAS20"
}

Response samples

Content type
application/json
{
  • "checkout_id": 21388601015,
  • "transaction_ref": "20260520145-178028",
  • "transaction_total": 198,
  • "transaction_tax": 18,
  • "transaction_discount": 0,
  • "transaction_status": "Incomplete",
  • "eventzilla_fee": 5.63,
  • "currency": "USD",
  • "tickets": [
    • {
      • "ticket_price_id": 1362622,
      • "ticket_type_id": 2138120411,
      • "ticket_type_name": "Early bird admission"
      },
    • {
      • "ticket_price_id": 1362623,
      • "ticket_type_id": 2138120411,
      • "ticket_type_name": "Early bird admission"
      }
    ]
}

Fill checkout order

Request Body schema: application/json
required
eventid
required
integer

Event identifier.

eventdateid
required
integer

Event date/occurrence identifier.

checkout_id
required
integer

Checkout identifier.

required
Array of objects (BuyerDetails)

Buyer information.

Array
buyer_firstname
string

Buyer first name.

buyer_lastname
string

Buyer last name.

buyer_email
string <email>

Buyer email address.

required
Array of objects (CheckoutFillOrderTicket)

Attendee/ticket details.

Array
ticket_price_id
integer

Ticket price/item identifier from checkout/create.

first_name
string

Attendee first name.

last_name
string

Attendee last name.

email
string <email>

Attendee email address.

Array of objects (TicketAnswer)

Answers to registration questions.

Array
question_id
integer

Question identifier.

answer_text
string

Answer text.

payment_id
required
integer

Payment option identifier.

Responses

Response Schema: application/json
checkout_id
integer

Checkout identifier.

transaction_ref
string

Transaction reference.

transaction_total
number

Transaction total.

transaction_tax
number

Tax amount.

transaction_discount
number

Discount amount.

transaction_status
string

Transaction status.

eventzilla_fee
number

Eventzilla fee.

Array of objects (CheckoutCreatedTicket)
Array
ticket_price_id
integer

Generated ticket price/item identifier.

ticket_type_id
integer

Ticket type identifier.

ticket_type_name
string

Ticket type name.

currency
string

Currency symbol or code.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "eventid": 2138988852,
  • "eventdateid": 2138985706,
  • "checkout_id": 21388601015,
  • "buyerdetails": [
    • {
      • "buyer_firstname": "Amelia",
      • "buyer_lastname": "Chen",
      • "buyer_email": "amelia.chen@example.com"
      }
    ],
  • "tickets": [
    • {
      • "ticket_price_id": 1362622,
      • "first_name": "Amelia",
      • "last_name": "Chen",
      • "email": "amelia.chen@example.com",
      • "answers": [
        • {
          • "question_id": 2138360281,
          • "answer_text": "Northstar SaaS"
          }
        ]
      },
    • {
      • "ticket_price_id": 1362623,
      • "first_name": "Noah",
      • "last_name": "Williams",
      • "email": "noah.williams@example.com",
      • "answers": [
        • {
          • "question_id": 2138360281,
          • "answer_text": "Northstar SaaS"
          }
        ]
      }
    ],
  • "payment_id": 2138979179
}

Response samples

Content type
application/json
{
  • "checkout_id": 21388601015,
  • "transaction_ref": "20260520145-178028",
  • "transaction_total": 198,
  • "transaction_tax": 18,
  • "transaction_discount": 0,
  • "transaction_status": "Incomplete",
  • "eventzilla_fee": 5.63,
  • "currency": "USD"
}

Confirm checkout order

Request Body schema: application/json
required
eventid
required
integer

Event identifier.

eventdateid
required
integer

Event date/occurrence identifier.

checkout_id
required
integer

Checkout identifier.

payment_status
required
string

Payment status for ticket confirmation.

comments
string

Order confirmation comments.

sendemail
boolean
Default: true

Whether to send the confirmation email.

Responses

Response Schema: application/json
checkout_id
integer

Checkout identifier.

transaction_ref
string

Transaction reference.

transaction_total
number

Transaction total.

transaction_tax
number

Tax amount.

transaction_discount
number

Discount amount.

eventzilla_fee
number

Eventzilla fee.

transaction_status
string

Transaction status.

confirmation_email_sent
boolean

Whether a confirmation email was sent to the buyer.

currency
string

Currency symbol or code.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "eventid": 2138988852,
  • "eventdateid": 2138985706,
  • "checkout_id": 21388601015,
  • "payment_status": "success",
  • "comments": "Payment confirmed.",
  • "sendemail": false
}

Response samples

Content type
application/json
{
  • "checkout_id": 21388601015,
  • "transaction_ref": "20260520145-178028",
  • "transaction_total": 198,
  • "transaction_tax": 18,
  • "transaction_discount": 0,
  • "eventzilla_fee": 5.63,
  • "transaction_status": "confirmed",
  • "confirmation_email_sent": false,
  • "currency": "USD"
}

Attendees

Retrieve attendee records and manage check-in status.

Get attendee details

path Parameters
attendeeid
required
integer

Attendee identifier.

Responses

Response Schema: application/json
Array of objects (Attendee)
Array
first_name
string

Attendee first name.

last_name
string

Attendee last name.

ticket_type
string

Ticket/registration type registered by this attendee.

bar_code
string

Unique barcode associated with this attendee.

is_attended
string

Check-in/attendance status.

transaction_ref
string

Order reference for this transaction.

refno
string

Order reference number used by attendee lookup endpoints.

Array of objects (QuestionAnswer)

Registration question answers.

Array
questionid
integer

Question identifier, if returned.

questions
string

Question text.

answer
string

Answer text.

id
integer

Transaction or attendee-related identifier returned by the endpoint.

transaction_date
string <date-time>

Transaction timestamp.

number or string (FlexibleNumber)
One of
number
event_date
string <date-time>

Event date associated with this attendee.

transaction_status
string

Transaction status.

user_id
integer

Buyer/user identifier.

event_id
integer

Event identifier.

title
string

Event title.

email
string <email>

Buyer email address.

buyer_first_name
string

Buyer first name.

buyer_last_name
string

Buyer last name.

promo_code
string

Promo/discount code, if used.

payment_type
string

Payment method.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "attendees": [
    • {
      • "first_name": "Amelia",
      • "last_name": "Chen",
      • "ticket_type": "Early bird admission",
      • "bar_code": "EZ202605200001",
      • "is_attended": "No",
      • "questions": [
        • {
          • "questions": "Company",
          • "answer": "Northstar SaaS"
          }
        ],
      • "refno": "20260520145-178028",
      • "id": 2139049165,
      • "event_date": "2026-05-20T09:00:00",
      • "event_id": 2138988852,
      • "transaction_date": "2026-05-01T10:15:00",
      • "transaction_amount": 99,
      • "transaction_status": "Confirmed",
      • "title": "Chicago SaaS Growth Summit",
      • "email": "amelia.chen@example.com",
      • "buyer_first_name": "Amelia",
      • "buyer_last_name": "Chen",
      • "payment_type": "Card"
      }
    ]
}

Check in or revert attendee check-in

Get attendees by associated Client

Request Body schema: application/json
required
barcode
required
string

Unique barcode from the attendee's ticket.

required
boolean or string

true to check in the attendee, false to revert check-in.

One of
boolean

true to check in the attendee, false to revert check-in.

Responses

Response Schema: application/json
first_name
string

Attendee first name.

last_name
string

Attendee last name.

eventtitle
string

Event title.

orderref
string

Order reference.

orderef
string
Deprecated

Historical misspelling of orderref found in examples.

email
string <email>

Attendee email address.

status
string

Check-in or check-out status.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Request samples

Content type
application/json
{
  • "barcode": "EZ202605200001",
  • "eventcheckin": true
}

Response samples

Content type
application/json
{
  • "first_name": "Amelia",
  • "last_name": "Chen",
  • "eventtitle": "Chicago SaaS Growth Summit",
  • "orderref": "20260520145-178028",
  • "email": "amelia.chen@example.com",
  • "status": "Checkin"
}

Users

Retrieve organizer and sub-organizer profile details.

List users

query Parameters
offset
integer
Default: 0

Number of records to skip.

limit
integer
Default: 20

Maximum number of records to return.

Responses

Response Schema: application/json
Array of objects (Pagination)
Array
offset
integer

Records skipped before returning this page.

limit
integer

Maximum records returned in this page.

total
integer

Total records available for this request.

Array of objects (User)
Array
id
integer

Unique organizer identifier.

username
string

Organizer username.

first_name
string

Organizer first name.

last_name
string

Organizer last name.

company
string

Organizer company name.

address_line1
string

Address line 1.

address_line2
string

Address line 2.

address_locality
string

City/locality.

address_region
string

State, province, or region.

address_country
string

Country.

zip_code
string

ZIP/postal code.

email
string <email>

Organizer email address.

timezone
string

Organizer time zone.

website
string

Organizer website URL.

phone_primary
string

Primary phone number.

avatar_url
string

Organizer avatar image URL.

facebook_id
string

Facebook profile/page URL or identifier.

twitter_id
string

Twitter/X profile URL or identifier.

last_seen
string <date-time>

Last updated/last seen timestamp for the organizer account.

user_type
string

User type, such as organizer or sub-organizer.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "pagination": [
    • {
      • "offset": 0,
      • "limit": 20,
      • "total": 1
      }
    ],
  • "users": [
    • {
      • "id": 2130004479,
      • "username": "events@example.com",
      • "first_name": "Maya",
      • "last_name": "Patel",
      • "company": "Northstar Events",
      • "address_line1": "123 Eagle Street",
      • "address_line2": "",
      • "zip_code": "4000",
      • "address_locality": "Chicago",
      • "address_region": "IL",
      • "address_country": "United States",
      • "email": "maya.patel@example.com",
      • "timezone": "UTC",
      • "phone_primary": "+61 7 3000 1234",
      • "avatar_url": "",
      • "facebook_id": "",
      • "twitter_id": "",
      • "last_seen": "2026-05-20T08:21:37",
      • "user_type": "organizer"
      }
    ]
}

Get user details

path Parameters
userid
required
integer

User/organizer identifier.

Responses

Response Schema: application/json
Array of objects (Pagination)
Array
offset
integer

Records skipped before returning this page.

limit
integer

Maximum records returned in this page.

total
integer

Total records available for this request.

Array of objects (User)
Array
id
integer

Unique organizer identifier.

username
string

Organizer username.

first_name
string

Organizer first name.

last_name
string

Organizer last name.

company
string

Organizer company name.

address_line1
string

Address line 1.

address_line2
string

Address line 2.

address_locality
string

City/locality.

address_region
string

State, province, or region.

address_country
string

Country.

zip_code
string

ZIP/postal code.

email
string <email>

Organizer email address.

timezone
string

Organizer time zone.

website
string

Organizer website URL.

phone_primary
string

Primary phone number.

avatar_url
string

Organizer avatar image URL.

facebook_id
string

Facebook profile/page URL or identifier.

twitter_id
string

Twitter/X profile URL or identifier.

last_seen
string <date-time>

Last updated/last seen timestamp for the organizer account.

user_type
string

User type, such as organizer or sub-organizer.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "users": [
    • {
      • "id": 2130004479,
      • "username": "events@example.com",
      • "first_name": "Maya",
      • "last_name": "Patel",
      • "company": "Northstar Events",
      • "address_line1": "123 Eagle Street",
      • "address_line2": "",
      • "zip_code": "4000",
      • "address_locality": "Chicago",
      • "address_region": "IL",
      • "address_country": "United States",
      • "email": "maya.patel@example.com",
      • "timezone": "UTC",
      • "phone_primary": "+61 7 3000 1234",
      • "avatar_url": "",
      • "facebook_id": "",
      • "twitter_id": "",
      • "last_seen": "2026-05-20T08:21:37",
      • "user_type": "organizer"
      }
    ]
}

Transactions

Look up order and payment transactions by reference or checkout ID.

Get transaction by checkout ID or reference number

path Parameters
identifier
required
string

Checkout ID or order reference number.

Responses

Response Schema: application/json
Array of objects (EventTransaction)
Array
transaction_ref
string

Order reference for this transaction.

checkout_id
integer

Checkout identifier.

transaction_date
string <date-time>

Transaction timestamp.

number or string (FlexibleNumber)
One of
number
tickets_in_transaction
integer

Number of tickets/attendees in the transaction.

event_date
string <date-time>

Event date associated with the transaction.

transaction_status
string

Transaction status.

user_id
integer

Buyer user identifier.

buyer_id
integer

Buyer identifier; used in some transaction documentation.

event_id
integer

Event identifier.

title
string

Event title.

email
string <email>

Buyer email address.

buyer_first_name
string

Buyer first name.

buyer_last_name
string

Buyer last name.

promo_code
string

Promo/discount code, if used.

payment_type
string

Payment method.

comments
string

Transaction comments or notes.

number or string (FlexibleNumber)
One of
number
number or string (FlexibleNumber)
One of
number
number or string (FlexibleNumber)
One of
number
refno
string

Order reference number used by transaction lookup endpoints.

Response Schema: application/json
status
required
integer

HTTP status code.

error_code
required
string

Readable error code.

message
required
string

Detailed error message.

Response samples

Content type
application/json
{
  • "transaction": [
    • {
      • "refno": "20260520145-178028",
      • "checkout_id": 2138868785,
      • "transaction_date": "2026-05-20T14:20:20",
      • "transaction_amount": 198,
      • "tickets_in_transaction": 2,
      • "event_date": "2026-05-20T09:00:00",
      • "transaction_status": "Confirmed",
      • "user_id": 42628,
      • "event_id": 2138988852,
      • "title": "Chicago SaaS Growth Summit",
      • "email": "amelia.chen@example.com",
      • "buyer_first_name": "Amelia",
      • "buyer_last_name": "Chen",
      • "promo_code": "",
      • "payment_type": "Card",
      • "comments": "",
      • "transaction_tax": 18,
      • "transaction_discount": 0,
      • "eventzilla_fee": 5.63
      }
    ]
}