Reporting endpoint - Event ticket ownership report

Overview

Organizers can now easily extract tickets ownership for a specific event. This report is generated for a single event and aims to provide a detailed list of tickets along with comprehensive wallet owner information, including opt-in statuses.

Some business logic has been applied to the report :

Each valid ticket will correspond to one row in the report, excluding tickets with the status of 'DELETED'
For tickets that are only INJECTED:
- If an owner account exists, full owner details are included.
- If an owner account does not exist, the report will include the email, first name, and last name from the ticket's initial owner fields.

Parameters

eventId (required): specify ONE event ID. The Event ID is visible in the Event list in Backoffice:

Where to find the Event ID in Backoffice

mobileAppId (required): specify the applicable application identifier

Where to fin the Mobile App ID in Backoffice

excludeDeleted : true/false, false by default

limit (required): maximum number of results to extract

offset (required): skip the first N results (pagination)

Data returned

total

integer

Total number of ticket available (for pagination if needed)

result

List of tickets

ticketId	string Ticket ID
eventId	string Event ID
organizerId	string Organizer ID
eventName	string Event Name
eventCode	string Organizer event ID
eventStartDate	string($date-time) Start date and time of the event
ownerEmail	string Email address of the current ticket owner
ownerFirstName	string First name of the ticket owner
ownerLastName	string Last name of the ticket owner
ownerPhone	string Phone number of the ticket owner
ownerBirthDate	string($date) Birth date of the ticket owner
ownerIdNumber	string Identity number of the ticket owner
ownerResidenceCountry	string Country of residence of the ticket owner
ownerAllowPromoEmail	[...]
ownerAllowPromoThirdPartyEmail	boolean Indicates if the owner allows third-party promo emails
ownerAllowTracking	boolean Indicates if the owner consents to tracking
ticketNumber	string Ticket number
ticketBarcode	string Barcode of the ticket
organizerTicketId	string Organizer ticket ID
ticketHolder	{ description: Ticket holder details }
previousOwnerId	string ID of
initialOwnerId	string ID of the initial owner
status	string Current status of the ticket
activated	boolean Indicates if the ticket has been activated
checked	boolean Indicates if the ticket has been checked
assigned	boolean Indicates if the ticket has been assigned
controlled	boolean Indicates if the ticket has been controlled
keptByOwner	boolean Indicates if the ticket has been kept by owner
purchaseFile	string Purchase file
purchaseDate	string Purchase date
purchasePrice	string Purchase price
purchaseCurrency	string Currency used in the ticket purchase
purchaseContingentId	string Purchase contingent ID
purchaseSeatCategoryId	string Purchase seat category ID
purchaseTariffId	string Purchase tariff ID
seatingSeated	boolean Indicates if this ticket has an assigned seat
seatingNumbered	boolean Indicates if the seat is numbered
seatingExternalEntrance	string External entrance information
seatingGate	string Gate information
seatingArea	string Area information
seatingLevel	string Level information
seatingBlock	string Block information
seatingRow	string Row information
seatingSeat	string Seat information
ticketMetadata	{ description: Extra metadata related to the ticket }
activationRuleId	string Activation rule ID
usageRuleId	string Usage rule ID
designRuleId	string Design rule I
dataCollectionRuleId	string Data collection rule ID
emailRuleId	string Email rule ID
devicesMap	{ description: Device information mapped to the ticket }
activationDetails	[ Ticket activation details {...}]
deletionDate	string($date-time) Date the ticket was marked as deleted
deletionReason	string Reason the ticket was deleted
transferForwardCount	integer Number of times the ticket was transferred forward
transferBackwardCount	integer Number of times the ticket was returned to a previous owner
alreadyDownloaded	boolean Indicates if the ticket has already been downloaded