What is on sale and how many are left for a date
https://api.app2email.com/v1/{number}/tickets/events/{id}/availability Scope: tickets:manage. For one date of an event: on_sale (buyers can buy now), closed (cancelled or ended when the date takes no order from anyone), sold_out, and every active ticket type with its state as a buyer meets it, how many are left (null: nothing limits it), the most one order may take (max) and the all-in price. date_id is needed when the event has several scheduled dates (400 invalid_ticket_event without it). Buyers buy on the event's url.
Path
-
Your app2email WhatsApp number - the number the message is sent FROM. Full number with country code, digits only.
e.g.4976659348270 -
The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX).
e.g.summer-quiz
Query
- date_id integer
The date's id. Needed when the event has more than one scheduled date.
e.g.31
Responses
Fields
- success boolean
- request_id string
- event object
- date object
One date (session) of an event. A one-off event has exactly one. Also inside ticket.event.sold_out and ticket.event.cancelled.
18 fields
- id integer
The date's id.
e.g.31 - event_id integer
The event it belongs to.
e.g.12 - start string (date-time)
When it starts (UTC).
- end string (date-time)
When it ends (UTC).
- start_local string
The start as clock time in the event's time zone (yyyy-MM-ddTHH:mm).
e.g.2026-12-12T19:30 - end_local string
The end as clock time in the event's time zone.
e.g.2026-12-12T21:30 - label string
A short name of the date, eg Late show. Empty when it has none.
- capacity integer | null
How many people fit: the date's own limit, else the event's; with a seat plan the places of the plan. null = no limit.
- sales string
paused: nothing is sold for this date right now.
onpaused - status string
scheduledendedcancelled - sold integer | null
Valid tickets (extras not counted). The five counts sold, people, held, left and checked_in are null inside webhook events, in the door list and in next_date of the events list.
- people integer | null
The people those tickets admit (a group ticket admits several).
- held integer | null
People in baskets right now.
- left integer | null
People that can still be sold. null = no limit, or the counts were not read.
- checked_in integer | null
People admitted at the door.
- sold_out boolean
The date sold its last public ticket and no place has come back since.
- changed string (date-time) | null
When the time or the venue last changed and ticket holders were told.
- cancelled string (date-time) | null
When the date was cancelled.
- on_sale boolean
Buyers can buy for this date now.
- closed string
Empty, or why the date takes no order from anyone.
cancelledended - sold_out boolean
- max_per_order integer
The most tickets one order may hold.
- types object[]
Every active ticket type and extra, hidden ones too. Archived ones never.
10 item fields
- type_id integer
- name string
- role string
ticketaddon - visibility string
publichidden - state string
How a buyer meets the type now. waiting: it opens when another type sells out. hidden: only with a code.
on_salesold_outnot_yetendedwaitinghidden - left integer | null
How many are left. null = nothing limits it.
- max integer
The most one order may take of it now.
- price number
The all-in price of one; for price_mode choose the least amount.
- price_label string
- sales_end string (date-time) | null
When its sale ends.
Errors
- 400 The request is malformed (missing or invalid fields, query parameters or times).
- 401 Missing, invalid, revoked or expired API key.
- 403 The key is valid but this call is not allowed: the key lacks the scope the call needs (insufficient_scope), the address is not allowed for the key (ip_not_allowed), the number or plan does not allow it, a recipient opted out or is not opted in, or a problem with the WhatsApp account.
- 404 The number, template, message, broadcast, webhook, delivery, opt-in, logged request, booking or Flow was not found.
- 429 A monthly plan limit, the number's own monthly cap, the key's daily cap, a WhatsApp rate limit, the API rate limit (rate_limited), or the webhook test limit (too_many_tests) was reached. Retry-After and error.retry_after_seconds say how long to wait.
- 500 Unexpected error on app2email's side.