Reporting endpoint - Ticket status logs

Reporting endpoint - Ticket status logs

Overview

This endpoint exposes the TIXNGO ticket status logs stored in the Reporting Domain.
It enables you to:

  • Analyze spectators’ ticket transfer activity (incoming and outgoing transfers)

  • Focus on specific actions to understand user behavior

Be mindful of the volume of data involved! Please try to focus on date range as short as possible.

If you have significant volume of data to analyze, Excel and Power BI desktop are NOT the right tools. In those contexts, direct API integration or Power BI services with incremental refresh activated MUST be used.

Endpoint

The endpoint to fetch ticket status logs is:

GET /organizer/report/ticket-status-logs

Parameters

Required

  • mobileAppId (string)
    Identifier of the mobile application for which you want to retrieve logs.

app ID.png
  • from (date‑time)
    Start of the date‑time range for which logs are returned.

  • to (date‑time)
    End of the date‑time range for which logs are returned.
    Using a mandatory date range prevents dumping millions of records for large organizers.

Optional filters

  • actionNames (string, multiple values supported)
    Filter by action type (for example: Download, Activate, Log off, …).

  • fromStatuses (string, multiple values supported)
    Filter by initial ticket status before the action.

  • toStatuses (string, multiple values supported)
    Filter by ticket status after the action.

  • fromOwnerId (string)
    Filter by previous ticket owner.

  • toOwnerId (string)
    Filter by new / current ticket owner.

  • actor (string)
    Filter by actor that performed the action (for example: mobile device, back‑office user, …).

Pagination

  • limit (integer, optional; default as configured, max 10 000)
    Maximum number of items returned in one page.
    The maximum allowed value is 10 000.

  • paginationKey (string, optional) If not provided, the first page of results is returned. Use the nextPageKey from the previous response to get the next page.

Data returned

pagination

pageSize

integer

Number of items returned in this page

nextPageKey

string

Key to fetch next page

result

List of ticket status log entries

ticketId

string

Ticket ID

ticketStatusLogId

string(int)

Ticket version number (incremented at every change of the ticket) at the time of the status change

actor

string

actor (Device, Backoffice user, etc.) triggered the action

actionName

string

action name (DOWNLOAD, ACTIVATE, START_TRANSFER, …).
See https://go.confluence.secutix.com/wiki/spaces/TIXNGO/pages/134088291/Tickets+V4#Ticket-Actions

fromStatus

string

Status before action (more details https://go.confluence.secutix.com/wiki/spaces/TIXNGO/pages/134088291/Tickets+V4#Ticket-Status)

toStatus

string

Status after action (more details https://go.confluence.secutix.com/wiki/spaces/TIXNGO/pages/134088291/Tickets+V4#Ticket-Status)

fromOwnerId

string

For transfer log entries only: spectator ID of the sender

toOwnerId

string

For transfer log entries only: spectator ID of the recipient

spectatorId

string

Spectator ID of the current owner of the ticket

transferMessage

string

For transfer log entries only: message sent by the user.

transferGroup

string

Transfer group: unique identifier of a Transfer between two spectators of one or several tickets https://go.confluence.secutix.com/wiki/spaces/TIXNGO/pages/134088515/Transfers+V4#New-concept%3A-%E2%80%9CTransfer-Group%E2%80%9D

transferLang

string
Transfer Language

controlledDate

date-time

Only for action “CONTROL”: timestamp when the ticket has been controlled by the access control system

deletionReason

string

Reason for deletion (details: https://go.confluence.secutix.com/wiki/spaces/TIXNGO/pages/134088291/Tickets+V4#New-Ticket-Deletion-Reasons)

activationDetails

string

Only for ACTIVATE action: JSON object with details of the activation that happened like method, etc.

ticketTransferDirection

string

Last transfer direction (incoming, outgoing)

checked

boolean

Whether the ticket is checked (more detail: https://go.confluence.secutix.com/wiki/spaces/TIXNGO/pages/134088291/Tickets+V4#Ticket-Attributes)

keptByOwner

boolean

Whether the ticket is kept by owner (more detail: https://go.confluence.secutix.com/wiki/spaces/TIXNGO/pages/134088291/Tickets+V4#Ticket-Attributes)

eventID

string

Event ID

contingentId

string

Contingent ID

mobileDateTime

date-time

Date time of mobile’s log

devices

string

Devices name

transferDirection

string

Direction of ticket transfer (incoming or outgoing) for the pending transfer (applies only to tickets in pending transfer)

createdDate

date-time

Date time of log creation

updatedDate

date-time

Date time of log update