Public event catalog (B2C discovery)

Public (no auth). Lists PUBLISHED events with at least one upcoming date. Filters: q (text), city, from/to (ISO 8601), page, pageSize (≤50), sort (date_asc | price_asc | price_desc). Returns a summary with the next date and two ‘from’ prices: priceFrom (base, no fees) and buyerTotalFrom (what the buyer pays for one unit of that same ticket type, including service fee, VAT (IVA) and seat surcharge). Cache-friendly, no personal data.

GET/events

Query parameters

qstring

Search by name/description

citystring

Filter by venue city

fromstring

Dates from (ISO 8601)

tostring

Dates until (ISO 8601)

pageinteger

Page (default 1)

default: 1

pageSizeinteger

Page size (default 20, max 50)

default: 20

sortstring

date_asc | price_asc | price_desc

Allowed:date_ascprice_ascprice_desc

Responses

200

dataPublicEventSummary[]required

Show properties

Array of PublicEventSummary

slugstringrequired

namestringrequired

descriptionstring | nullrequired

Show properties

Any of:

string

string

null

null

coverImageUrlstring | nullrequired

Show properties

Any of:

string

string

null

null

citystring | nullrequired

Show properties

Any of:

string

string

null

null

nextDatestring | nullrequired

Show properties

Any of:

string

string

null

null

priceFromnumber | nullrequired

Cheapest BASE price, excluding service fee, VAT (IVA) and the numbered-seat surcharge. To quote what the buyer actually pays, use buyerTotalFrom.

Show properties

Any of:

number

number

null

null

buyerTotalFromnumber | nullrequired

Final per-unit price of the ticket type with the cheapest base price (includes service fee, VAT (IVA) and the numbered-seat surcharge). The authoritative order total is computed by POST /orders.

Show properties

Any of:

number

number

null

null

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

Base URLCustom base URLOverrides the selected server when set.

Parameters

qquerySearch by name/descriptioncityqueryFilter by venue cityfromqueryDates from (ISO 8601)toqueryDates until (ISO 8601)pagequeryPage (default 1)pageSizequeryPage size (default 20, max 50)sortquerydate_asc | price_asc | price_desc

Request

curl -X GET 'https://appfreeticket.com/api/public/events'

const response = await fetch("https://appfreeticket.com/api/public/events", {
  method: "GET"
});

import requests

response = requests.get(
    "https://appfreeticket.com/api/public/events",
)

Response

{
  "data": [
    {
      "slug": "string",
      "name": "string",
      "description": "string",
      "coverImageUrl": "string",
      "city": "string",
      "nextDate": "string",
      "priceFrom": 0,
      "buyerTotalFrom": 0,
      "currency": "string"
    }
  ]
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}