Skip to content
FreeTicketDocs
Esc
↑↓navigate↵open⌘Jpreview

Detail of a buyer's ticket (deep link)

Requires the X-Customer-Session header. The enterprise service API key is OPTIONAL: with a key, results are additionally scoped to the workspace pinned to the key; without a key, any of the buyer’s own tickets is visible, not limited to a workspace. {id} accepts the sale id or its reference. Returns 404 if the ticket does not belong to the session’s buyer or falls outside the scope.

GET/customer/tickets/{id}
Authorization
AuthorizationAPI key · headerrequired

API key prefixed with Bearer . Alternative: the x-api-key header with the raw key. Available scopes: read and write (see /.well-known/oauth-protected-resource).

or
x-api-keyAPI key · headerrequired

Raw API key (without Bearer ), alternative to Authorization.

Path parameters
idstringrequired
Header parameters
X-Workspace-Idstring

Active workspace to operate on. Optional: when omitted, the default workspace of the user who owns the key is used (pickActiveOrg).

Responses
200

OK

dataCustomerSalerequired
Show properties
idstringrequired
referencestringrequired
statusstringrequired
eventobjectrequired
Show properties
namestringrequired
slugstringrequired
eventDateobjectrequired
Show properties
startsAtstringrequired

Event start instant in ISO 8601 UTC.

timezonestringrequired

IANA time zone of the event.

itemsCustomerTicketItem[]required
Show properties
Array of CustomerTicketItem
ticketTypeNamestringrequired
quantityintegerrequired
min -9007199254740991 · max 9007199254740991
ticketCodestringrequired

Opaque ticket code. The QR code must encode the validator URL (https://admin.appfreeticket.com/dashboard/tickets/validar?code=<ticketCode>).

seatLabelstring | nullrequired

Exact seat for seated events (seats.io), or null.

Show properties
Any of:
string
string
null
null
totalnumberrequired
currencystringrequired
401

Missing or invalid credential.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
403

Insufficient role or resource not accessible.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
404

Resource does not exist or is out of scope.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
422

Request body/parameter validation failed.

errorobjectrequired
Show properties
codestringrequired
messagestringrequired
retryablebooleanrequired
detailsany
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://admin.appfreeticket.com/api/v1/customer/tickets/string' \
  -H 'Authorization: YOUR_API_KEY'
Response
{
  "data": {
    "id": "string",
    "reference": "string",
    "status": "string",
    "event": {
      "name": "string",
      "slug": "string"
    },
    "eventDate": {
      "startsAt": "string",
      "timezone": "string"
    },
    "items": [
      {
        "ticketTypeName": "string",
        "quantity": -9007199254740991,
        "ticketCode": "string",
        "seatLabel": "string"
      }
    ],
    "total": 0,
    "currency": "string"
  }
}