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

Live availability by date and ticket type

Public (no auth). Live stock (capacity - sold - reserved) per date and ticket type, upcoming dates only. Each type includes the base price (price) and the final per-unit price (buyerTotal = price + service fee + VAT (IVA) + numbered-seat surcharge): quote the buyer with buyerTotal, not price. For NUMBERED ticket types (seatsioCategoryKey not null), availableSeats lists the exact label of every seat free right now — those labels are what goes into items[].seats in POST /orders. Check this before creating an order. Do not cache aggressively: stock (and seats) change.

GET/events/{slug}/availability
Path parameters
slugstringrequired
Responses
200

OK

dataPublicAvailabilityrequired
Show properties
slugstringrequired
datesobject[]required
Show properties
Array of object
idstringrequired
labelstring | nullrequired
Show properties
Any of:
string
string
null
null
startsAtstringrequired
endsAtstring | nullrequired
Show properties
Any of:
string
string
null
null
timezonestringrequired
venueNamestring | nullrequired
Show properties
Any of:
string
string
null
null
citystring | nullrequired
Show properties
Any of:
string
string
null
null
ticketTypesPublicTicketType[]required
Show properties
Array of PublicTicketType
idstringrequired
namestringrequired
descriptionstring | nullrequired
Show properties
Any of:
string
string
null
null
pricenumberrequired
buyerServiceFeenumberrequired

Service fee paid by the buyer, including the numbered-seat surcharge. 0 if the organizer absorbs the fee and the ticket type is not numbered.

seatingSurchargenumberrequired

Flat per-seat surcharge for numbered ticket types (seats.io). Already included in buyerServiceFee and buyerTotal; exposed separately so it can be itemized.

ivanumberrequired

VAT (IVA, 19%) on the service fee.

buyerTotalnumberrequired

Final price PER UNIT: price + buyerServiceFee + iva. This is what checkout charges; the order total is confirmed by POST /orders.

seatsioCategoryKeystring | nullrequired
Show properties
Any of:
string
string
null
null
availableSeatsPublicAvailableSeat[]
Show properties
Array of PublicAvailableSeat
labelstringrequired

EXACT seat label in seats.io.

categoryKeystring | nullrequired
Show properties
Any of:
string
string
null
null
categoryLabelstring | nullrequired
Show properties
Any of:
string
string
null
null
statusstringrequired
currencystringrequired
maxPerOrderintegerrequired
min -9007199254740991 · max 9007199254740991
availableintegerrequired
min -9007199254740991 · max 9007199254740991
soldOutbooleanrequired
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
Parameters
Request
curl -X GET 'https://appfreeticket.com/api/public/events/string/availability'
Response
{
  "data": {
    "slug": "string",
    "dates": [
      {
        "id": "string",
        "label": "string",
        "startsAt": "string",
        "endsAt": "string",
        "timezone": "string",
        "venueName": "string",
        "city": "string",
        "ticketTypes": [
          {
            "id": "string",
            "name": "string",
            "description": "string",
            "price": 0,
            "buyerServiceFee": 0,
            "seatingSurcharge": 0,
            "iva": 0,
            "buyerTotal": 0,
            "seatsioCategoryKey": "string",
            "availableSeats": [
              {
                "label": "string",
                "categoryKey": "string",
                "categoryLabel": "string",
                "status": "free"
              }
            ],
            "currency": "string",
            "maxPerOrder": -9007199254740991,
            "available": -9007199254740991,
            "soldOut": true
          }
        ]
      }
    ]
  }
}