One event, as something you can sell

Prod Env

GET

/api/v1/sell/events/{ref}

The ticket types, what is left of each, the questions the organizer wants
answered, and the limits a basket is judged against.

Prices here are informational — the authoritative number comes back from
POST /quote and is computed again at checkout.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

API Key

Add parameter in header

X-Etick-Key

Example:

X-Etick-Key: ********************

Path Params

Responses

🟢200

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429RateLimited

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/sell/events/summer-gala' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "id": "66f0a1c2d3e4f5a6b7c8d9e0",
    "slug": "summer-gala",
    "title": "Summer Gala",
    "description": "string",
    "category": "string",
    "ageRestriction": "18+",
    "startsAt": "2026-07-12T20:00",
    "endsAt": "string",
    "timezone": "Asia/Baku",
    "venueName": "Heydar Aliyev Center",
    "address": "string",
    "lat": 0,
    "lng": 0,
    "coverImageUrl": "string",
    "posterImageUrl": "string",
    "organizerName": "Acme Events",
    "seating": "general_admission",
    "currency": "AZN",
    "status": "on_sale",
    "maxTicketsPerOrder": 10,
    "capacity": 500,
    "sold": 160,
    "available": 340,
    "tiers": [
        {
            "id": "vip",
            "name": "VIP",
            "description": "Front rows, includes the after-party",
            "price": 50,
            "color": "#c026d3",
            "available": 12,
            "soldOut": false
        }
    ],
    "questions": [
        {
            "id": "q1",
            "label": "Company name",
            "required": false
        }
    ],
    "paymentsEnabled": true,
    "acceptsPromoCodes": true,
    "checkoutUrl": "string"
}

Modified at 2026-09-02 12:00:03

List the events this key sells

What a basket costs