The ticket orders, newest first
https://api.app2email.com/v1/{number}/tickets/orders Scope: tickets:manage. Newest first. Left out, status gives every order except the unfinished checkouts (pending and expired). Find a buyer's orders with contact, email or q (the reference, the buyer's or a holder's name, a seat label, a promo code). from and to filter by the day the order was made; attention=true gives the orders that need a look (a failed or disputed payment, a refund that does not add up); tickets=true adds each order's tickets. page_url opens the tickets without a login: give it only to the buyer. Page with next_cursor.
Path
-
Your app2email WhatsApp number - the number the message is sent FROM. Full number with country code, digits only.
e.g.4976659348270
Query
- event_id integer
Only orders of this event (its id).
e.g.12 - date_id integer
Only orders for this date (its id).
e.g.31 - status string
Only orders in this state. Left out: every state except pending and expired.
pendingconfirmedpartly_refundedrefundedcancelledexpired - kind string
online: paid by card. free: a free order. comp: complimentary. outside: paid outside.
onlinefreecompoutside - contact string
The buyer: a WhatsApp number with country code, digits only, or a business-scoped user id.
e.g.61412345678 - email string
The buyer's email address.
- q string
Search in the reference, the buyer's or a holder's name, a seat label or a promo code (2 to 80 characters).
- from string
Orders made from this day (YYYY-MM-DD in the number's time zone) or ISO 8601 time.
e.g.2026-11-01 - to string
Orders made up to this day (included) or ISO 8601 time.
e.g.2026-11-30 - attention boolean
true: only orders that need a look.
- tickets boolean
true: each order carries its tickets.
-
How many (1 to 200, default 50).
- cursor string
The next_cursor of the previous answer, unchanged. Leave out for the first page.
Responses
Fields
- success boolean
- request_id string
- orders object[]
Newest first.
42 item fields
- id integer
The order's id.
e.g.8812 - reference stringe.g.
TK-7H3KQ9 - status string
pending: a checkout that is not finished. expired: it was never paid or confirmed. confirmed: the tickets were issued.
pendingconfirmedpartly_refundedrefundedcancelledexpired - kind string
online: paid by card. free: a free order. comp: complimentary. outside: paid outside app2email.
onlinefreecompoutside - channel string
Where it was made.
webwhatsappstaffdoorapi - source string
The src label of the link the buyer came through.
- event object
- date object
The date that was bought.
4 fields
- id integer
- start string (date-time) | null
- start_local string
- label string
- buyer object
4 fields
- name string
- contact string
The WhatsApp number in digits, or a business-scoped user id. Empty when unknown; erased-... after an erase.
- email string
- no_whatsapp boolean
The buyer said they do not use WhatsApp.
- currency stringe.g.
AUD - total number
What the buyer pays, in currency.
- total_label stringe.g.
A$24.00 - tickets_total number
The sum of the ticket prices.
- order_fee number
- donation number
- discount number
Information: already taken off tickets_total.
- fees number
Information: the booking fees inside total.
- tax number
Information: the tax inside total.
- refunded number
- refunded_label string
Empty while nothing was refunded.
- ticket_count integer
Tickets of role ticket.
- people_count integer
The people they admit.
- addon_count integer
- promo_code string
- payment object
- comp_reason string
kind comp: guest, artist, press, sponsor, staff, prize or other.
- staff_note string
The business's internal note.
- created_by string
customer, a person of the business, or API key <name>.
- attention string
Not empty: the order needs a look. dispute: the buyer's bank opened a card dispute and the tickets are blocked.
refund_failedrefund_outsiderefund_mismatchpaid_twicedispute - close_reason string
Why it ended without tickets: unpaid, buyer_cancelled, staff_cancelled, late_payment, date_cancelled, event_cancelled or erased.
- refund_request object | null
A refund the buyer asked for. null when there is none.
-
The answers given for the order: question id -> value.
- marketing_optin boolean
- erased boolean
The buyer's details were erased on request.
- page_url string
The ticket page of this order. Anyone who has the link can open the tickets: treat it like a password and give it only to the buyer. Empty in webhook events and for an erased order.
- expires string (date-time) | null
pending: until when it can be paid or confirmed.
- confirmed string (date-time) | null
When the tickets were issued.
- cancelled string (date-time) | null
- refunded_at string (date-time) | null
- created string (date-time)
- updated string (date-time)
- tickets object[]
Every ticket of the order, any status. In GET /tickets/orders only with tickets=true.
29 item fields
- id integer
The ticket's id.
e.g.501 - order_id integere.g.
8812 - order_reference stringe.g.
TK-7H3KQ9 - event_id integere.g.
12 - date_id integer
The date the ticket is for.
e.g.31 - type_id integere.g.
44 - type_name string
The ticket type's name as it was sold.
e.g.Adult - role string
- seq integer
1..n inside the order.
- status string
valid and blocked tickets hold a place; refunded, cancelled and transferred (passed on) are final.
- holder_name string
- answers object
The answers given for this ticket: question id -> value.
- seat object | null
null without a seat.
- admits integer
- check_in object
The check-in state of a ticket.
TicketCheckIn (not expanded) - currency string
- price number
What was paid for this ticket, all in: what a refund of it returns.
- price_label string
- face number
The all-in list price before a discount.
- refunded number
- refunded_at string | null
- block_reason string
Why staff blocked it. A disputed payment reads Payment disputed.
- passed_on boolean
true: the ticket was made when a holder passed a ticket on.
- replaces_id integer
The ticket this one replaced. 0 = none.
- replaced_by_id integer
The ticket that replaced this one. 0 = none.
- page_url string
The ticket page of this ticket. Anyone who has the link can open the ticket: treat it like a password and give it only to the buyer. Empty in webhook events, for an erased order and for a ticket that is no longer valid.
- created string
- updated string
- buyer object
Only in the rows of GET /tickets/issued: who bought it.
- next_cursor string | null
Pass it as cursor for the next page. null on the last page.
- count integer
How many rows this answer has.
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.