Skip to content
Eventpop API Documentation
GitHub

Find a specific ticket

GET
/tickets/search

Searches for a ticket by event ID and reference code within the organizer’s events. Requires Application Access Token (the application must be owned by the event’s organizer). Useful for ticket validation and check-in systems.

Parameters

Query Parameters

event_id
required
string

Event ID

reference_code
required
string

Ticket reference code (e.g., "ABC123")

access_token
string

OAuth Token (alternative to Authorization header)

Responses

200

Search ticket by reference code

PublicAPI_Entities_Ticket model

object
id

Unique ticket identifier

integer format: int32
order_id

ID of the order this ticket belongs to

integer format: int32
event_id

ID of the event this ticket is for

integer format: int32
status

Ticket status (e.g., “active”, “used”, “revoked”)

string
firstname

Ticket holder first name

string
lastname

Ticket holder last name

string
phone

Ticket holder phone number

string
email

Ticket holder email address

string
reference_code

Unique reference code for ticket validation (e.g., “ABC123”)

string
kind

Ticket kind (e.g., “normal”, “external”)

string
external_id

External system identifier for idempotency

string
revoke_note

Note explaining why ticket was revoked

string
ticket_type

Ticket type information including name and price

object
id
string
name
string
price
string
price_satangs
string
kind
string
price_label

Ticket price label (formatted price, “Free”, complimentary note, or pack pricing)

string
forms

Custom form field responses for this ticket

array
created_at

Ticket creation timestamp (ISO 8601 format)

string
updated_at

Last update timestamp (ISO 8601 format)

string
used_at

Check-in timestamp (ISO 8601 format), null if not used

string
registered_at

Registration timestamp (ISO 8601 format), null if not registered

string

401

Unauthorized - Invalid token

404

Ticket not found - Invalid event ID, reference code, or organizer mismatch