---
title: "Updated order"
method: POST
path: "updatedOrder"
tags: ["Orders"]
---

# Updated order

`POST updatedOrder` (webhook)

ORDER.UPDATED webhook triggered when existing order is updated.

## Payload

- object
  - `id` string — A unique identifier for the webhook history
  - `created_at` string — Datetime of the webhook request
  - `event` string — Webhook subscription event
  - `resource_url` string — API link to the order
  - `payload` Order
    - `object` string, required
    - `id` string, required — A unique identifier for the order
    - `buyer_details` object, required — Information buyer provided in the checkout
      - `address` object, required — Information about buyer address
        - `address_1` string, nullable, required — First line of address
        - `address_2` string, nullable, required — Second line of address
        - `address_3` string, nullable, required — Third line of address
        - `postal_code` string, nullable, required — Postal code, zip code or postcode
      - `custom_questions` object[] — Buyer provided answers to custom questions in checkout
        - `question` string
        - `answer` string, nullable
      - `email` string, required — Buyer email address
      - `first_name` string, required — Buyer first name
      - `last_name` string, required — Buyer last name
      - `name` string, required — Buyer full name
      - `phone` string, nullable, required — Buyer phone number
    - `created_at` integer, required — Order creation timestamp
    - `currency` object, required — Information about order currency
      - `code` 'gbp' | 'usd' | 'eur' | 'sgd' | 'aud' | 'brl' | 'cad' | 'czk' | 'dkk' | 'hkd' | 'huf' | 'ils' | 'jpy' | 'myr' | 'mxn' | 'nok' | 'nzd' | 'php' | 'pln' | 'rub' | 'sek' | 'chf' | 'twd' | 'thb' | 'try', required — Currency used for purchase
      - `base_multiplier` integer, required — Base multiplier for conversions
    - `event_summary` object — Short event summary this order was made for
      - `id` string — ID of the event occurrence an order belongs to (deprecated)
      - `event_id` string — ID of the event occurrence an order belongs to
      - `event_series_id` string — ID of the event series an order belongs to
      - `name` string — Name of the event
      - `start_date` object — The start date for the event in various formats
        - `date` string, required — ISO-8601 date for the start of the event
        - `formatted` string, required — A formatted date string for the start of the event
        - `iso` string, required — ISO-8601 date and time for the start of the event
        - `time` string, required — Time for the start of the event
        - `timezone` string, required — Timezone offset for the start of the event
        - `unix` integer, required — Unix timestamp for the start of the event
      - `end_date` object — The end date for the event in various formats
        - `date` string, required — ISO-8601 date for the end of the event
        - `formatted` string, required — A formatted date string for the end of the event
        - `iso` string, required — ISO-8601 date and time for the end of the event
        - `time` string, required — Time for the end of the event
        - `timezone` string, required — Timezone offset for the end of the event
        - `unix` integer, required — Unix timestamp for the end of the event
      - `venue` object — The venue information for the event
        - `country` string, nullable — Country of the venue
        - `name` string, nullable, required — The name of the venue
        - `postal_code` string, nullable, required — The postcode of the venue for this event
    - `issued_tickets` IssuedTicket[], nullable, required — Issued tickets for order
      - `object` string, required
      - `id` string, required — A unique identifier for the issued ticket
      - `add_on_id` string, nullable — A unique identifier for the associated product
      - `barcode` string, required — Barcode text value
      - `barcode_url` string, required — URL to barcode image
      - `checked_in` string, required — Returns whether or not issued ticket is checked in
      - `created_at` integer, required — Timestamp when issued ticket was created
      - `custom_questions` object[], required — Buyer provided answers to custom questions in checkout
        - `question` string
        - `answer` string, nullable
      - `description` string, required
      - `email` string, nullable, required — The order email address
      - `event_id` string, required — ID of the event issued ticket belongs to
      - `event_series_id` string, required — ID of the event series the issued ticket belongs to
      - `group_ticket_barcode` string, nullable, required — Barcode for group ticket, if it is part of one
      - `reference` string, nullable, required — An external reference for imported tickets (via the API or Dashboard)
      - `full_name` string, nullable, required — Full name of attendee
      - `first_name` string, nullable, required — First name of attendee
      - `last_name` string, nullable, required — Last name of attendee
      - `listed_currency` object, nullable — List currency of the ticket type at the time of purchase
        - `base_multiplier` integer
        - `code` 'gbp' | 'usd' | 'eur' | 'sgd' | 'aud' | 'brl' | 'cad' | 'czk' | 'dkk' | 'hkd' | 'huf' | 'ils' | 'jpy' | 'myr' | 'mxn' | 'nok' | 'nzd' | 'php' | 'pln' | 'rub' | 'sek' | 'chf' | 'twd' | 'thb' | 'try'
      - `listed_price` integer, nullable — List price of the ticket type at the time of purchase
      - `reservation` string, nullable, required — Reservation from seating chart where applicable
      - `status` 'valid' | 'voided', required
      - `source` 'api' | 'dashboard_import', nullable, required
      - `ticket_type_id` string, nullable, required — ID of the ticket type
      - `updated_at` integer, required — Timestamp when issued ticket was last updated
      - `voided_at` integer, nullable, required — Timestamp when issued ticket was voided
      - `order_id` string, nullable, required — A unique identifier for the order
      - `qr_code_url` string, required — URL to QR code image
    - `sold_products` SoldProduct[], nullable, required — Sold products for order
      - `object` string, required
      - `id` string, required — A unique identifier for the sold product
      - `event_id` string, nullable, required — ID of the event if sold through event sales channel
      - `fulfilment` 'none' | 'issued_ticket' | 'issued_membership' | 'issued_voucher', required — Type of fulfilment for this product
      - `fulfilment_reference_id` string, nullable, required — Prefixed ID of the issued ticket (it_), membership (im_), or voucher (vo_) if fulfilled
      - `fulfilment_reference_name` string, nullable, required — Name/label of the fulfilment reference
      - `order_id` string, required — A unique identifier for the order
      - `product_id` string, required — A unique identifier for the product
      - `product_name` string, required — Name of the product
      - `sales_channel` 'event' | 'store', required — Where the product was sold (event or store)
      - `sales_channel_reference_name` string, required — Display name of the event or store
      - `status` 'valid' | 'voided', required — Status of the sold product
      - `store_id` integer, nullable, required — ID of the store if sold through store sales channel
    - `line_items` object[], required
      - `object` string, required
      - `id` string, required — A unique identifier for the basket item
      - `booking_fee` integer, required — Optional booking fee which is charged per ticket type to the customer and the funds are paid to you.
      - `description` string, required — Basket item description
      - `item_id` string, nullable — The line item type id with a prefix.
      - `quantity` integer, required — Amount of line item objects
      - `store_id` string, nullable — The store id prefixed with 'st_'
      - `total` integer, required — Total amount including tax for line item
      - `type` 'ticket' | 'transaction_charge' | 'void' | 'tax' | 'gift_card' | 'donation', required — `ticket` is a purchased ticket, `transaction_charge` is a transaction fee to orders. This is charged once per order as opposed to ticket booking fees which are charged once per ticket. `void` means ticket was voided after the purchase, `tax` is sales tax eg. VAT, `gift_card` is discount or voucher applied and `donation` is for donating value
      - `value` integer, required — Amount without tax
    - `marketing_opt_in` string, nullable — Whether the buyer opted in to receive marketing emails
    - `meta_data` object[] — Meta data attached to the order
      - `key` string
      - `value` string, nullable
    - `notes` string, nullable — Notes attached to the order
    - `payment_method` PaymentMethod, required
      - `external_id` string, nullable, required — A unique identifier for the payment method
      - `id` string, nullable, required — A unique identifier for internal payment methods
      - `type` 'no_cost' | 'offline' | 'operator' | 'paypal' | 'stripe' | 'transfer', required — The type of payment method
      - `name` string, nullable, required — Name of the payment method
      - `instructions` string, nullable, required — Instructions for the customer on how to pay. Used for offline payments.
      - `additional_stripe_payment_methods` string[], required — Additional Stripe payment methods enabled on this method, e.g. ideal, klarna. Empty for non-Stripe types.
      - `paypal_pay_later_enabled` string, required — Whether PayPal Buy Now Pay Later is enabled on this method. Always false for non-PayPal types.
      - `min_order_value` number, float, nullable, required — Minimum order total required to use this payment method. Used for offline methods.
      - `max_order_value` number, float, nullable, required — Maximum order total allowed for this payment method. Used for offline methods.
      - `lead_time_before_event` integer, nullable, required — Minimum number of days before the event start that an order using this payment method must be placed. Used for offline methods.
    - `refund_amount` integer, required — Refunded amount in cents
    - `refunded_voucher_id` integer, nullable, required — The unique identifier for the existing voucher
    - `credited_out_amount` integer — Refunded amount issued as credit in cents
    - `referral_tag` string, nullable, required — A unique tag to track where sales originated
    - `status` 'completed' | 'pending' | 'cancelled', required — Possible states of the order
    - `status_message` string, nullable, required — Message associated with status.
    - `subtotal` integer, required — Sum without tax
    - `tax` integer, required — Tax sum
    - `tax_treatment` 'exclusive' | 'inclusive' — How tax was calculated
    - `total` integer, required — Total value of order
    - `total_paid` integer, required — Total amount paid for this order including tax
    - `txn_id` string, nullable, required — A unique identifier for the transaction

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.net/tickettailor/apis/ticket-tailor-api.md) · [All operations](https://skmtc.net/tickettailor/apis/ticket-tailor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tickettailor/ticket-tailor-api/revisions/7b222e8ec91c/schema)
