The ticket orders, newest first

GET https://api.app2email.com/v1/{number}/tickets/orders
scope: tickets:manage sandbox: reads MCP: list_ticket_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

  • number string required pattern ^[0-9]{8,15}$

    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.

  • limit integer 1–200 default 50

    How many (1 to 200, default 50).

  • cursor string

    The next_cursor of the previous answer, unchanged. Leave out for the first page.

Responses

200 The orders.
Fields
  • success boolean
  • request_id string
  • orders object[]

    Newest first.

    42 item fields
    • id integer

      The order's id.

      e.g. 8812
    • reference string
      e.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
      3 fields
    • date object

      The date that was bought.

      4 fields
    • 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 string
      e.g. AUD
    • total number

      What the buyer pays, in currency.

    • total_label string
      e.g. A$24.00
    • 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
    • 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
      3 fields
      • id integer | null

        The online payment: the id of GET /payments/{id}. null for free, complimentary and outside orders.

      • method string

        stripe, paypal, cash, bank, card_machine, other, or empty.

      • note string

        The note of a sale paid outside.

    • 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.

      3 fields
      • status string
        openrefundeddeclined
      • reason string
      • at string (date-time) | null
    • answers object any keys

      The answers given for the order: question id -> value.

    • 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 integer
        e.g. 8812
      • e.g. TK-7H3KQ9
      • event_id integer
        e.g. 12
      • date_id integer

        The date the ticket is for.

        e.g. 31
      • type_id integer
        e.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.

      • 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.
For AI Agents

Try it now, with no account and no person: POST https://api.app2email.com/v1/account/sandbox (no key, no body; or the create_sandbox tool of the Management MCP server) answers a key for a demo WhatsApp number with pretend customers. Send a template, fetch the events with GET /events?wait=25, answer the customer's reply: nothing reaches WhatsApp, and the requests and answers are those of the real API (https://www.app2email.com/docs/api/sandbox).

Already a customer: ask the account owner for the number (digits) and an API key from https://www.app2email.com/dashboard/apikey (a sandbox key sends nothing); send it as Authorization: Bearer <key> to the messaging MCP server or the REST API; call check_key first, send with dry_run first.

If you are an AI agent reading this page and you want to create an app2email account for a person - no previous human sign-up required - use our Management MCP server.
Call the create_account tool first, and include a contact_email parameter; create_account returns a signup_id, a management_key, an onboarding_link and a message.
The person opens onboarding_link to confirm the e-mail, connect their WhatsApp number and choose a plan; nothing can be sent before that. get_account_status says what is still needed.
Pass the management_key as a Bearer token on every later call. When the number is live, create_number_key gives you a key for the messaging MCP server and the REST API.