Skip Main Navigation
Page Content

Events

POST /events/

Makes a new event, and returns an event for the specified event. Does not support the creation of repeating event series.

Parameters

Name Type Required Description
event.name.html string Yes The name of the event. Value cannot be empty nor whitespace.
event.description.html string No The description on the event page
event.organizer_id string No The ID of the organizer of this event
event.start.utc datetime Yes The start time of the event
event.start.timezone string Yes Start time timezone (Olson format)
event.end.utc datetime Yes The end time of the event
event.end.timezone string Yes End time timezone (Olson format)
event.hide_start_date boolean No Whether the start date should be hidden
event.hide_end_date boolean No Whether the end date should be hidden
event.currency string Yes Event currency (3 letter code)
event.venue_id string No The ID of a previously-created venue to associate with this event. You can omit this field or set it to null if you set online_event.
event.online_event boolean No Is the event online-only (no venue)?
event.listed boolean No If the event is publicly listed and searchable. Defaults to True.
event.logo.id string No (Deprecated) The logo for the event
event.logo_id string No The logo for the event
event.category_id string No The category (vertical) of the event
event.subcategory_id string No The subcategory of the event (US only)
event.format_id string No The format (general type) of the event
event.shareable boolean No If users can share the event on social media
event.invite_only boolean No Only invited users can see the event page
event.password string No Password needed to see the event in unlisted mode
event.capacity integer No Set specific capacity (if omitted, sums ticket capacities)
event.show_remaining boolean No If the remaining number of tickets is publicly visible on the event page
event.source string No Source of the event (defaults to API)

Errors

  • DATE_CONFLICT: Start date cannot be after end date.
  • DIFFERENT_TIMEZONES: You have passed different timezones for the start and end times (they must be the same)
  • INVALID_DATE: Start and end dates cannot be in the past.
  • INVITE_CONFLICT: You have set both listed and invite_only; these two options are mutually exclusive, and you are only allowed to set one.
  • NO_DEFAULT_ORGANIZER: The event does not have an organizer ID, and no default organizer could be found for the user.
  • NO_VENUE: You have attempted to create an event without a venue.
  • PASSWORD_CONFLICT: You have set both listed and password; these two options are mutually exclusive, and you are only allowed to set one.
  • SHARE_INVITE_CONFLICT: You have set both shareable and invite_only; these two options are mutually exclusive, and you are only allowed to set one.
  • UNSUPPORTED_TIMEZONE: The time zone for the start and end times does not exist.
  • VENUE_AND_ONLINE: You have set both online_event and venue_id; an event can event can either have a venue or be online, but not both at the same time.

GET /events/:id/

Returns an event for the specified event. Many of Eventbrite’s API use cases revolve around pulling details of a specific event within an Eventbrite account. Does not support fetching a repeating event series parent (see GET /series/:id/).

Parameters

Takes no parameters

Errors

No endpoint-specific errors

POST /events/:id/

Updates an event. Returns an event for the specified event. Does not support updating a repeating event series parent (see POST /series/:id/).

Parameters

Name Type Required Description
event.name.html string No The name of the event. Value cannot be empty nor whitespace.
event.description.html string No The description on the event page
event.organizer_id string No The ID of the organizer of this event
event.start.utc datetime No The start time of the event
event.start.timezone string No Start time timezone (Olson format)
event.end.utc datetime No The end time of the event
event.end.timezone string No End time timezone (Olson format)
event.hide_start_date boolean No Whether the start date should be hidden
event.hide_end_date boolean No Whether the end date should be hidden
event.currency string No Event currency (3 letter code)
event.venue_id string No ID of the venue
event.online_event boolean No Is the event online-only (no venue)?
event.listed boolean No If the event is publicly listed and searchable. Defaults to True.
event.logo.id string No (Deprecated) The logo for the event
event.logo_id string No The logo for the event
event.category_id string No The category (vertical) of the event
event.subcategory_id string No The subcategory of the event (US only)
event.format_id string No The format (general type) of the event
event.shareable boolean No If users can share the event on social media
event.invite_only boolean No Only invited users can see the event page
event.password string No Password needed to see the event in unlisted mode
event.capacity integer No Set specific capacity (if omitted, sums ticket capacities)
event.show_remaining boolean No If the remaining number of tickets is publicly visible on the event page
event.source string No Source of the event (defaults to API)

Errors

  • CANNOT_UPDATE_CURRENCY: Cannot update event with paid sales or reserved seats.
  • DATE_CONFLICT: Start date cannot be after end date.
  • DIFFERENT_TIMEZONES: You have passed different timezones for the start and end times (they must be the same)
  • INVALID_DATE: Start and end dates cannot be in the past.
  • INVITE_CONFLICT: You have set both listed and invite_only; these two options are mutually exclusive, and you are only allowed to set one.
  • NO_DEFAULT_ORGANIZER: The event does not have an organizer ID, and no default organizer could be found for the user.
  • NO_PAYMENT_OPTIONS: This event has paid tickets but no payment options configured.
  • NO_VENUE: You have attempted to update an event without a venue.
  • PASSWORD_CONFLICT: You have set both listed and password; these two options are mutually exclusive, and you are only allowed to set one.
  • PAYMENT_OPTIONS_DEPRECATED_SPLIT_FEES: This event has split fees configured. Split fees are no longer supported, and you cannot create events with split fees enabled.
  • PAYMENT_OPTIONS_NO_COUNTRY: This event has paid tickets but no payment country configured.
  • PAYMENT_OPTIONS_NO_PAYMENT_TYPE: This event has paid tickets but no payment type configured.
  • PAYMENT_OPTIONS_PAYPAL_NO_EMAIL: This event has paid tickets and is configured to use PayPal, but no PayPal email address has been specified.
  • SHARE_INVITE_CONFLICT: You have set both shareable and invite_only; these two options are mutually exclusive, and you are only allowed to set one.
  • UNSUPPORTED_TIMEZONE: The time zone for the start and end times does not exist.
  • VENUE_AND_ONLINE: You have set both online_event and venue_id; an event can either have a venue or be online, but not both at the same time.

POST /events/:id/publish/

Publishes an event if it has not already been deleted. In order for publish to be permitted, the event must have all necessary information, including a name and description, an organizer, at least one ticket, and valid payment options. This API endpoint will return argument errors for event fields that fail to validate the publish requirements. Returns a boolean indicating success or failure of the publish.

Parameters

Takes no parameters

Errors

  • ALREADY_PUBLISHED_OR_DELETED: This event has already been published or deleted.
  • NO_PAYMENT_OPTIONS: This event has paid tickets but no payment options configured.
  • PAYMENT_OPTIONS_DEPRECATED_SPLIT_FEES: This event has split fees configured. Split fees are no longer supported, and you cannot publish events with split fees enabled.
  • PAYMENT_OPTIONS_NO_COUNTRY: This event has paid tickets but no payment country configured.
  • PAYMENT_OPTIONS_NO_PAYMENT_TYPE: This event has paid tickets but no payment type configured.
  • PAYMENT_OPTIONS_PAYPAL_NO_EMAIL: This event has paid tickets and is configured to use PayPal, but no PayPal email address has been specified.

Argument Errors

  • event.name - MISSING: Your event must have a name to be published.
  • event.start - MISSING: Your event must have a start date to be published.
  • event.end - MISSING: Your event must have an end date to be published.
  • event.start.timezone - MISSING: Your event start and end dates must have matching time zones to be published.
  • event.organizer - MISSING: Your event must have an organizer to be published.
  • event.currency - MISSING: Your event must have a currency to be published.
  • event.currency - INVALID: Your event must have a valid currency to be published.
  • event.tickets - MISSING: Your event must have at least one ticket to be published.
  • event.tickets.N.name - MISSING: All tickets must have names in order for your event to be published. The N will be the ticket class ID with the error.
  • event.tickets.N.quantity_total - MISSING: All non-donation tickets must have an available quantity value in order for your event to be published. The N will be the ticket class ID with the error.
  • event.tickets.N.cost - MISSING: All non-donation tickets must have a cost (which can be 0.00 for free tickets) in order for your event to be published. The N will be the ticket class ID with the error.

POST /events/:id/unpublish/

Unpublishes an event. In order for a free event to be unpublished, it must not have any pending or completed orders, even if the event is in the past. In order for a paid event to be unpublished, it must not have any pending or completed orders, unless the event has been completed and paid out. Returns a boolean indicating success or failure of the unpublish.

Parameters

Takes no parameters

Errors

  • CANNOT_UNPUBLISH: You have attempted to unpublish an event that has pending or completed sales of paid tickets (and that is not in the past, completed, and paid out), or has pending or completed sales of free tickets (ever).
  • NOT_PUBLISHED: This event is not currently published and cannot be unpublished.

POST /events/:id/cancel/

Cancels an event if it has not already been deleted. In order for cancel to be permitted, there must be no pending or completed orders. Returns a boolean indicating success or failure of the cancel.

Parameters

Takes no parameters

Errors

  • ALREADY_CANCELED: This event has already been canceled.
  • CANNOT_CANCEL: You have attempted to cancel an event that has pending or completed sales of paid tickets. The event cannot be canceled until all of these sales are refunded.

DELETE /events/:id/

Deletes an event if the delete is permitted. In order for a delete to be permitted, there must be no pending or completed orders. Returns a boolean indicating success or failure of the delete.

Parameters

Takes no parameters

Errors

  • ALREADY_DELETED
  • CANNOT_DELETE

GET /events/:id/display_settings/

Retrieves the display settings for an event.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

POST /events/:id/display_settings/

Updates the display settings for an event.

Parameters

Name Type Required Description
display_settings.show_start_date boolean No Whether to display the start date on the event listing
display_settings.show_end_date boolean No Whether to display the end date on the event listing
display_settings.show_start_end_time boolean No Whether to display event start and end time on the event listing
display_settings.show_timezone boolean No Whether to display the event timezone on the event listing
display_settings.show_map boolean No Whether to display a map to the venue on the event listing
display_settings.show_remaining boolean No Whether to display the number of remaining tickets
display_settings.show_organizer_facebook boolean No Whether to display a link to the organizer’s Facebook profile
display_settings.show_organizer_twitter boolean No Whether to display a link to the organizer’s Twitter profile
display_settings.show_facebook_friends_going boolean No Whether to display which of the user’s Facebook friends are going
display_settings.terminology string No Which terminology should be used to refer to the event (Valid choices are: tickets_vertical, or endurance_vertical)

Errors

No endpoint-specific errors

GET /events/:id/ticket_classes/

Returns a paginated response with a key of ticket_classes, containing a list of ticket_class.

Parameters

Name Type Required Description
pos string No Only return ticket classes valid for the given point of sale (Valid choices are: online, or at_the_door)

Errors

No endpoint-specific errors

POST /events/:id/ticket_classes/

Creates a new ticket class, returning the result as a ticket_class under the key ticket_class.

Parameters

Name Type Required Description
ticket_class.name string No Name of this ticket type
ticket_class.description string No Description of the ticket
ticket_class.quantity_total integer No Total available number of this ticket
ticket_class.cost currency No Cost of the ticket (currently currency must match event currency) e.g. $45 would be ‘USD,4500’
ticket_class.donation boolean No Is this a donation? (user-supplied cost)
ticket_class.free boolean No Is this a free ticket?
ticket_class.include_fee boolean No Absorb the fee into the displayed cost
ticket_class.split_fee boolean No Absorb the payment fee, but show the eventbrite fee
ticket_class.hide_description boolean No Hide the ticket description on the event page
ticket_class.sales_channels list No A list of all supported sales channels ([“online”], [“online”, “atd”], [“atd”])
ticket_class.sales_start datetime No When the ticket is available for sale (leave empty for ‘when event published’)
ticket_class.sales_end datetime No When the ticket stops being on sale (leave empty for ‘one hour before event start’)
ticket_class.sales_start_after string No The ID of another ticket class - when it sells out, this class will go on sale.
ticket_class.minimum_quantity integer No Minimum number per order
ticket_class.maximum_quantity integer No Maximum number per order (blank for unlimited)
ticket_class.auto_hide boolean No Hide this ticket when it is not on sale
ticket_class.auto_hide_before datetime No Override reveal date for auto-hide
ticket_class.auto_hide_after datetime No Override re-hide date for auto-hide
ticket_class.hidden boolean No Hide this ticket
ticket_class.order_confirmation_message string No Order message per ticket type

Errors

  • AUTO_HIDE_NOT_SET: You must select an auto hide setting.
  • BAD_QUANTITIES: The sum of tickets across ticket classes is not equal to the sum of total tickets available.
  • COST_GREATER_THAN_FEE: The cost of the ticket class must be greater than the fee.
  • CURRENCY_MISMATCH: Event currency ticket currency must match.
  • DONATION_AND_COST: A ticket cannot be a donation and a charged ticket.
  • DONATION_AND_FREE: A ticket cannot be a donation and a free ticket.
  • DONATION_AND_MIN_QUANTITY: Please set a minimum quantity for donation ticket.
  • FREE_AND_COST: A ticket cannot be a free ticket and a charged ticket.
  • INVALID_EVENT: This event is not qualified to have tickets.
  • NO_COST: A price must be set for a charged ticket.
  • NO_QUANTITY_TOTAL: A quantity total must be set for this ticket.
  • SPLIT_AND_INCLUDE: You cannot split fees and include them in the price of the ticket.
  • SPLIT_FEES_DEPRECATED: This functionality is being deprecated.

GET /events/:id/ticket_classes/:ticket_class_id/

Gets and returns a single ticket_class by ID, as the key ticket_class.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

POST /events/:id/ticket_classes/:ticket_class_id/

Updates an existing ticket class, returning the updated result as a ticket_class under the key ticket_class.

Parameters

Name Type Required Description
ticket_class.name string No Name of this ticket type
ticket_class.description string No Description of the ticket
ticket_class.quantity_total integer No Total available number of this ticket
ticket_class.cost currency No Cost of the ticket (currently currency must match event currency) e.g. $45 would be ‘USD,4500’
ticket_class.donation boolean No Is this a donation? (user-supplied cost)
ticket_class.free boolean No Is this a free ticket?
ticket_class.include_fee boolean No Absorb the fee into the displayed cost
ticket_class.split_fee boolean No Absorb the payment fee, but show the eventbrite fee
ticket_class.hide_description boolean No Hide the ticket description on the event page
ticket_class.sales_channels list No A list of all supported sales channels ([“online”], [“online”, “atd”], [“atd”])
ticket_class.sales_start datetime No When the ticket is available for sale (leave empty for ‘when event published’)
ticket_class.sales_end datetime No When the ticket stops being on sale (leave empty for ‘one hour before event start’)
ticket_class.sales_start_after string No The ID of another ticket class - when it sells out, this class will go on sale.
ticket_class.minimum_quantity integer No Minimum number per order
ticket_class.maximum_quantity integer No Maximum number per order (blank for unlimited)
ticket_class.auto_hide boolean No Hide this ticket when it is not on sale
ticket_class.auto_hide_before datetime No Override reveal date for auto-hide
ticket_class.auto_hide_after datetime No Override re-hide date for auto-hide
ticket_class.hidden boolean No Hide this ticket
ticket_class.order_confirmation_message string No Order message per ticket type

Errors

  • AUTO_HIDE_NOT_SET: You must select an auto hide setting.
  • BAD_QUANTITIES: The sum of tickets across ticket classes is not equal to the sum of total tickets available.
  • CANNOT_UPDATE_COST: Cannot change the ticket price after tickets have been sold
  • CIRCULAR_SALES_START_AFTER: Cannot start circular sales.
  • COST_GREATER_THAN_FEE: The cost of the ticket class must be greater than the fee.
  • CURRENCY_MISMATCH: Event currency ticket currency must match.
  • DONATION_AND_COST: A ticket cannot be a donation and a charged ticket.
  • DONATION_AND_FREE: A ticket cannot be a donation and a free ticket.
  • DONATION_AND_MIN_QUANTITY: Please set a minimum quantity for donation ticket.
  • FREE_AND_COST: A ticket cannot be a free ticket and a charged ticket.
  • INVALID_EVENT: Create or update the ticket from the parent event instead.
  • NO_COST: A price must be set for a charged ticket.
  • NO_QUANTITY_TOTAL: A quantity total must be set for this ticket.
  • SPLIT_AND_INCLUDE: You cannot split fees and include them in the price of the ticket.
  • SPLIT_FEES_DEPRECATED: This functionality is being deprecated.

DELETE /events/:id/ticket_classes/:ticket_class_id/

Deletes the ticket class. Returns {"deleted": true}.

Parameters

Takes no parameters

Errors

  • HAS_ATTENDEES
  • IS_STARTED_AFTER
  • LAST_TICKET

GET /events/:id/canned_questions/

This endpoint returns canned questions of a single event (examples: first name, last name, company, prefix, etc.). This endpoint will return question.

Parameters

Name Type Required Description
as_owner boolean No Return private events and more details

Errors

No endpoint-specific errors

GET /events/:id/questions/

Eventbrite allows event organizers to add custom questions that attendees fill out upon registration. This endpoint can be helpful for determining what custom information is collected and available per event.

This endpoint will return question.

Parameters

Name Type Required Description
as_owner boolean No Return private events and more details

Errors

No endpoint-specific errors

GET /events/:id/questions/:id/

This endpoint will return question for a specific question id.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

GET /events/:id/attendees/

Returns a paginated response with a key of attendees, containing a list of attendee.

Parameters

Name Type Required Description
status string No Limits results to either confirmed attendees or cancelled/refunded/etc. attendees (Valid choices are: attending, not_attending, or unpaid)
changed_since datetime No Only return attendees changed on or after the time given
last_item_seen integer No Only return attendees changed on or after the time given and with an id bigger than last item seen

Errors

No endpoint-specific errors

GET /events/:id/attendees/:attendee_id/

Returns a single attendee by ID, as the key attendee.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

GET /events/:id/orders/

Returns a paginated response with a key of orders, containing a list of order against this event.

Parameters

Name Type Required Description
status string No Filter to active (attending), inactive (not attending), all (both) orders and all_not_deleted (active and inactive but not deleted) (Valid choices are: active, inactive, all, or all_not_deleted)
changed_since datetime No Only return orders changed on or after the time given
last_item_seen integer No Only return orders changed on or after the time given and with an id bigger than last item seen
only_emails list No Only include orders placed by one of these emails
exclude_emails list No Don’t include orders placed by any of these emails
refund_request_statuses list No Return only orders with selected refund requests statuses.

Errors

No endpoint-specific errors

GET /events/:id/discounts/

Returns a paginated response with a key of discounts, containing a list of discounts available on this event.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

Argument Errors

  • event_id - NOT_FOUND: The event id you are attempting to use does not exist.

POST /events/:id/discounts/

Creates a new discount; returns the result as a discount as the key discount.

Parameters

Name Type Required Description
discount.code string Yes Code used to activate discount
discount.amount_off currency No Fixed reduction amount
discount.percent_off string No Percentage reduction
discount.ticket_ids list No IDs of tickets to limit discount to
discount.quantity_available integer No Number of discount uses
discount.start_date datetime No Allow use from this date
discount.end_date datetime No Allow use until this date

Errors

  • DISCOUNT_ALREADY_EXISTS: The discount you are attempting to create already exists.
  • END_IN_PAST: The end date for the discount cannot be in the past.
  • END_TOO_LATE: The discount should end before the ticket sales end.
  • INVALID_TICKET_IDS: The ticket IDs you are attempting to use do not exist.
  • NO_AMOUNT_OR_PERCENT: You must select a flat amount or a percentage for the discount.
  • START_AFTER_END: The discount cannot start after it is set to end.
  • START_IN_PAST: The discount cannot start in the past.
  • START_TOO_LATE: The discount must start further from the start of the event.

GET /events/:id/discounts/:discount_id/

Gets a discount by ID as the key discount.

Parameters

Takes no parameters

Errors

  • NOT_SUPPORTED

POST /events/:id/discounts/:discount_id/

Updates a discount; returns the result as a discount as the key discount.

Parameters

Name Type Required Description
discount.code string Yes Code used to activate discount
discount.amount_off currency No Fixed reduction amount
discount.percent_off string No Percentage reduction
discount.ticket_ids list No IDs of tickets to limit discount to
discount.quantity_available integer No Number of discount uses
discount.start_date datetime No Allow use from this date
discount.end_date datetime No Allow use until this date

Errors

  • END_IN_PAST: The end date for the discount cannot be in the past.
  • END_TOO_LATE: The discount should end before the ticket sales end.
  • INVALID_TICKET_IDS: The ticket IDs you are attempting to use do not exist.
  • NOT_SUPPORTED: The discount you are trying to create is not valid.
  • NO_AMOUNT_OR_PERCENT: You must select a flat amount or a percentage for the discount.
  • START_AFTER_END: The discount cannot start after it is set to end.
  • START_IN_PAST: The discount cannot start in the past.
  • START_TOO_LATE: The discount must start further from the start of the event.

GET /events/:id/public_discounts/

Returns a paginated response with a key of discounts, containing a list of public discounts available on this event.

Note that public discounts and discounts have exactly the same form and structure; they’re just namespaced separately, and public ones (and the public GET endpoints) are visible to anyone who can see the event.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

POST /events/:id/public_discounts/

Creates a new public discount; returns the result as a discount as the key discount.

Parameters

Name Type Required Description
discount.code string Yes Code used to activate discount
discount.amount_off currency No Fixed reduction amount
discount.percent_off string No Percentage reduction
discount.ticket_ids list No IDs of tickets to limit discount to
discount.quantity_available integer No Number of discount uses
discount.start_date datetime No Allow use from this date
discount.end_date datetime No Allow use until this date

Errors

  • DISCOUNT_ALREADY_EXISTS: The discount you are attempting to create already exists.
  • END_IN_PAST: The end date for the discount cannot be in the past.
  • END_TOO_LATE: The discount should end before the ticket sales end.
  • INVALID_TICKET_IDS: The ticket IDs you are attempting to use do not exist.
  • NO_AMOUNT_OR_PERCENT: You must select a flat amount or a percentage for the discount.
  • START_AFTER_END: The discount cannot start after it is set to end.
  • START_IN_PAST: The discount cannot start in the past.
  • START_TOO_LATE: The discount must start further from the start of the event.

GET /events/:id/public_discounts/:discount_id/

Gets a public discount by ID as the key discount.

Parameters

Takes no parameters

Errors

  • NOT_SUPPORTED

POST /events/:id/public_discounts/:discount_id/

Updates a public discount; returns the result as a discount as the key discount.

Parameters

Name Type Required Description
discount.code string Yes Code used to activate discount
discount.amount_off currency No Fixed reduction amount
discount.percent_off string No Percentage reduction
discount.ticket_ids list No IDs of tickets to limit discount to
discount.quantity_available integer No Number of discount uses
discount.start_date datetime No Allow use from this date
discount.end_date datetime No Allow use until this date

Errors

  • END_IN_PAST: The end date for the discount cannot be in the past.
  • END_TOO_LATE: The discount should end before the ticket sales end.
  • INVALID_TICKET_IDS: The ticket IDs you are attempting to use do not exist.
  • NOT_SUPPORTED: The discount you are trying to create is not valid.
  • NO_AMOUNT_OR_PERCENT: You must select a flat amount or a percentage for the discount.
  • START_AFTER_END: The discount cannot start after it is set to end.
  • START_IN_PAST: The discount cannot start in the past.
  • START_TOO_LATE: The discount must start further from the start of the event.

DELETE /events/:id/public_discounts/:discount_id/

Deletes a public discount.

Parameters

Takes no parameters

Errors

  • INVALID

GET /events/:id/access_codes/

Returns a paginated response with a key of access_codes, containing a list of access_codes available on this event.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

POST /events/:id/access_codes/

Creates a new access code; returns the result as a access_code as the key access_code.

Parameters

Name Type Required Description
access_code.code string Yes Code used to initiate access
access_code.ticket_ids list Yes IDs of tickets to allow access to
access_code.quantity_available integer No Number of uses
access_code.start_date datetime No Allow use from this date
access_code.end_date datetime No Allow use until this date

Errors

  • END_IN_PAST: The end date for the discount cannot be in the past.
  • END_TOO_LATE: The discount should end before the ticket sales end.
  • INVALID_EVENT_ID: The Event ID you passed does not exist
  • INVALID_TICKET_IDS: The ticket IDs you are attempting to use do not exist.
  • START_AFTER_END: The discount cannot start after it is set to end.
  • START_IN_PAST: The discount cannot start in the past.
  • START_TOO_LATE: The discount must start further from the start of the event.

GET /events/:id/access_codes/:access_code_id/

Gets a access_code by ID as the key access_code.

Parameters

Takes no parameters

Errors

  • NOT_SUPPORTED

POST /events/:id/access_codes/:access_code_id/

Updates an access code; returns the result as a access_code as the key access_code.

Parameters

Name Type Required Description
access_code.code string Yes Code used to initiate access
access_code.ticket_ids list Yes IDs of tickets to allow access to
access_code.quantity_available integer No Number of uses
access_code.start_date datetime No Allow use from this date
access_code.end_date datetime No Allow use until this date

Errors

  • END_IN_PAST: The end date for the discount cannot be in the past.
  • END_TOO_LATE: The discount should end before the ticket sales end.
  • INVALID_TICKET_IDS: The ticket IDs you are attempting to use do not exist.
  • NOT_SUPPORTED: The access code you are trying to get is not valid.
  • NO_AMOUNT_OR_PERCENT: You must select a flat amount or a percentage for the discount.
  • START_AFTER_END: The discount cannot start after it is set to end.
  • START_IN_PAST: The discount cannot start in the past.
  • START_TOO_LATE: The discount must start further from the start of the event.

GET /events/:id/transfers/

Returns a list of transfers for the event.

Parameters

Name Type Required Description
changed_since datetime No Only return transfers changed on or after the time given

Errors

No endpoint-specific errors

GET /events/:id/teams/

Returns a list of teams for the event.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

GET /events/:id/teams/:id/

Returns information for a single teams.

Parameters

Takes no parameters

Errors

No endpoint-specific errors

GET /events/:id/teams/:id/attendees/

Returns attendees for a single teams.

Parameters

Takes no parameters

Errors

No endpoint-specific errors