Skip to content

Admit event patrons

Request

Attempt to admit one or more patrons to an event based on their ticket serial numbers. The endpoint accepts a list containing the serials of tickets to be redeemed. The system will admit any serials that are currently valid for the event sections that the redeemer is authorised to admit to, and return a list of those that were successfully redeemed.

Security
SessionKey(Required scopes: redeemer)
Path
eventintegerrequired

Unique identifier of the requested event

Bodyapplication/json
redeemerstringrequired

Human-readable name of the person redeeming the listed tickets

devicestringrequired

Unique identifier of the device the tickets are being redeemed from

serialsArray of stringsrequired

List of ticket serials to redeem for admission to this event

curl -i -X POST \
  'https://docs.ticketingevents.com/_mock/openapi/events/{event}/admissions' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "redeemer": "Butcher",
    "device": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36...",
    "serials": [
      "DAWIER-BACK75580348",
      "DAWIER-VIPV37536946",
      "DAWIER-BACK75580348"
    ]
  }'

Responses

One or more of the tickets identified by the provided serials grants admission to an authorised event section and have been successfully redeemed.

Bodyapplication/json
Array [
redeemerstring

Human-readable name of the person who redeemed the ticket

devicestring

Unique identifier of the device from which the ticket was redeemed

ticketstring

Serial number of the ticket that granted admission

patronobject

Full name and username of the TickeTing user admitted on this ticket

sectionobject

Name of the event section the patron was admitted to

admittedstring, (date-time)

The date and time at which the patron was admitted

]
Response
[
  {
    "redeemer": "Butcher",
    "device": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36...",
    "ticket": "DAWIER-BACK75580348",
    "patron": { … },
    "section": { … },
    "admitted": "2024-03-01T10:59:56+00:00"
  },
  {
    "redeemer": "Butcher",
    "device": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36...",
    "ticket": "DAWIER-VIPV37536946",
    "patron": { … },
    "section": { … },
    "admitted": "2024-03-01T10:59:56+00:00"
  }
]