> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # GetOrder # Package: ticketing # Namespace: OrderManagement # Method link: https://dev.wix.com/docs/api-reference/business-solutions/events/registration/ticketing/orders/get-order.md ## Permission Scopes: Read Basic Events Order Info: SCOPE.DC-EVENTS.READ-BASIC-ORDERS ## Introduction Retrieves an order, including ticket data. --- ## REST API ### Schema ``` Method: getOrder Description: Retrieves an order, including ticket data. URL: https://www.wixapis.com/events/v1/events/{eventId}/orders/{orderNumber} Method: GET # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: eventId, orderNumber Method parameters: param name: eventId | type: none | required: true query param name: fieldset | type: array
| description: Which fields to return. - enum: - TICKETS: Returns `tickets`. - DETAILS: Returns `archived`, `confirmed`, `created`, `firstName`, `fullName`, `lastName`, `method`, `reservationId`, `snapshotId`, `status`, `ticketsPdf`, `ticketsQuantity`, `totalPrice`. - FORM: Returns `checkoutForm`. - INVOICE: Returns `invoice`. param name: orderNumber | type: none | required: true Return type: GetOrderResponse - name: order | type: Order | description: Requested order. - name: orderNumber | type: string | description: Unique order number. - name: reservationId | type: string | description: Reservation GUID. - name: snapshotId | type: string | description: Payment snapshot GUID. Empty if `status` of the order is `"FREE"`. - name: eventId | type: string | description: Event GUID to which the order belongs. - name: contactId | type: string | description: Contact GUID of buyer, resolved using the email address specified. See the Contacts API for additional information. - name: memberId | type: string | description: Buyer member GUID, if applicable. See the Members API for additional information. - name: created | type: string | description: Date and time the order was created. - name: firstName | type: string | description: Guest first name. - name: lastName | type: string | description: Guest last name. - name: email | type: string | description: Guest email address. - name: checkoutForm | type: FormResponse | description: Checkout form response. When each purchased ticket is assigned to a guest, guest forms are returned for each ticket, and buyer info is returned. - name: inputValues | type: array | description: Form field inputs. - name: inputName | type: string | description: Form field input name. - name: value | type: string | description: Form field value. - name: values | type: array | description: Form field values. - name: confirmed | type: boolean | description: Whether the order is confirmed. Triggered once the payment gateway processes the payment and funds reach the merchant's account. - name: status | type: OrderStatus | description: Order status. - enum: - NA_ORDER_STATUS: Order status isn't available for this request fieldset. - FREE: Order is confirmed, no payment is required. - PENDING: Order was paid, but the payment gateway suspended the payment. - PAID: Order is paid. - OFFLINE_PENDING: Order is confirmed but must be paid via offline payment. Status needs to be manually updated to `"PAID"`. - INITIATED: Order is waiting for payment at the cashier. - CANCELED: Order is canceled. - DECLINED: Order payment is declined. - AUTHORIZED: Order payment is authorized. - VOIDED: Order payment is voided. - PARTIALLY_PAID: Order is partially paid with less than the total amount. - name: method | type: string | description: Payment method used for purchase, for example, "payPal", "creditCard", etc. - name: ticketsQuantity | type: integer | description: Amount of tickets ordered. - name: totalPrice | type: Money | description: Total order price. - name: currency | type: string | description: 3-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. For example, `USD`. - name: value | type: string | description: Monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99). Optionally, starts with a single (-), to indicate that the amount is negative. - name: ticketsPdf | type: string | description: Ticket PDF URL. - name: tickets | type: array | description: Tickets (generated after payment). - name: ticketNumber | type: string | description: Unique ticket number which is assigned automatically when creating a ticket. - name: orderNumber | type: string | description: Associated order number. - name: ticketDefinitionId | type: string | description: Ticket definition GUID. See the Ticket Definition API for additional information. - name: name | type: string | description: Ticket type. - name: price | type: Money | description: Ticket price. - name: free | type: boolean | description: Whether the ticket requires payment. - name: policy | type: string | description: Ticket and event policies. - name: checkIn | type: CheckIn | description: Ticket check-in. - name: created | type: string | description: Time of a ticket's check-in. - name: orderStatus | type: OrderStatus | description: Associated order status. - name: orderArchived | type: boolean | description: Whether the order and ticket are archived. If set to `true`, they aren't visible in the order list. - name: orderFullName | type: string | description: Buyer full name. - name: guestFullName | type: string | description: Guest full name. - name: guestDetails | type: GuestDetails | description: Guest personal details. - name: guestAssigned | type: boolean | description: Whether ticket belongs to assigned guest. - name: firstName | type: string | description: Guest first name. - name: lastName | type: string | description: Guest last name. - name: email | type: string | description: Guest email. - name: form | type: FormResponse | description: Full form response. - name: contactId | type: string | description: Contact GUID associated with this guest. - name: phone | type: string | description: Guest phone number. - name: archived | type: boolean | description: Whether the ticket is visible in an order. - name: memberId | type: string | description: Ticket owner member GUID. - name: anonymized | type: boolean | description: Whether ticket was anonymized by GDPR delete. Anonymized tickets no longer contain personally identifiable information (PII). - name: checkInUrl | type: string | description: Ticket check-in URL. Shown as QR code image in PDF.
Format: `"https://www.wixevents.com/check-in/{ticket number},{event id}"`
Example: `"https://www.wixevents.com/check-in/AAAA-AAAA-BB021,00000000-0000-0000-0000-000000000000"` - name: ticketPdfUrl | type: string | description: URL for ticket PDF download. - name: channel | type: ChannelType | description: Associated order checkout channel type. - enum: - ONLINE: Buyer created the order via an online channel, such as a website or mobile app. - OFFLINE_POS: Sales person created the order and collected the money. - name: walletPassUrl | type: string | description: URL to download a ticket in `.pkpass` format for Apple Wallet. - name: canceled | type: boolean | description: Whether ticket is canceled. - name: archived | type: boolean | description: Whether the order is archived. - name: anonymized | type: boolean | description: Whether the order is anonymized by GDPR delete. - name: fullName | type: string | description: Guest full name. - name: invoice | type: Invoice | description: Order invoice. - name: items | type: array | description: - name: id | type: string | description: Unique line item GUID. - name: quantity | type: integer | description: Line item quantity. - name: name | type: string | description: Line item name. - name: price | type: Money | description: Line item price. - name: total | type: Money | description: Total price for line items. Always equal to price * quantity. - name: discount | type: Discount | description: Discount applied to the line item. - name: amount | type: Money | description: Total discount amount. - name: afterDiscount | type: Money | description: Total sum after the discount. - name: discounts | type: array | description: Discount items. - ONE-OF: - name: coupon | type: CouponDiscount | description: Coupon discount. - name: name | type: string | description: Discount coupon name. **Deprecated:** Use `invoice.discounts.coupon.name` instead. - name: code | type: string | description: Discount coupon code. **Deprecated:** Use `invoice.discounts.coupon.code` instead. - name: couponId | type: string | description: Discount coupon GUID. **Deprecated:** Use `invoice.discounts.coupon.couponId` instead. - name: paidPlan | type: PaidPlanDiscount | description: Pricing plan discount. - ONE-OF: - name: percentDiscount | type: PercentDiscount | description: Discount by percentage applied to tickets. - name: rate | type: string | description: Percent rate. - name: quantityDiscounted | type: integer | description: Number of discounted tickets. - name: name | type: string | description: Name of pricing plan. - name: amount | type: Money | description: Total discount amount. - name: tax | type: Tax | description: Tax applied to the item. - name: type | type: TaxType | description: Tax type. - enum: - INCLUDED: Tax is included in the ticket price. - ADDED: Tax is added to the order at the checkout. - ADDED_AT_CHECKOUT: Tax is added to the final total at the checkout. - name: name | type: string | description: Tax name. - name: rate | type: string | description: Tax rate. - name: taxable | type: Money | description: Taxable amount. - name: amount | type: Money | description: Total tax amount. - name: fees | type: array | description: Fees applied to the item. - name: name | type: FeeName | description: Fee identifier. - enum: - WIX_FEE: Wix ticket service fee charges applied to the line item. - name: type | type: FeeType | description: How fee is calculated. - enum: - FEE_ADDED: Fee is added to the ticket price at checkout. - FEE_INCLUDED: Seller absorbs the fee. It's deducted from the ticket price. - FEE_ADDED_AT_CHECKOUT: Fee is added to the ticket price at checkout. - name: rate | type: string | description: Fee rate. - name: amount | type: Money | description: Total amount of fee charges. - name: discount | type: Discount | description: Discount applied to a cart. - name: tax | type: Tax | description: Tax applied to a cart. - name: subTotal | type: Money | description: Total cart amount before discount, tax, and fees. - name: grandTotal | type: Money | description: Total amount of a cart after discount, tax, and fees. Grand total is calculated in the following order: 1. Total prices of all items in the cart are calculated. 2. Discount is subtracted from the cart, if applicable. 3. Tax is added, if applicable. 4. Wix ticket service fee is added. - name: fees | type: array | description: Fees applied to the cart. - name: revenue | type: Money | description: Total revenue, excluding fees. Taxes and payment provider fees aren't deducted. - name: previewUrl | type: string | description: Invoice preview URL. Only returned if the order is paid. - name: fullyCheckedIn | type: boolean | description: Whether all tickets in an order are checked in. - name: paymentDetails | type: PaymentDetails | description: Internal order payment details. - name: transaction | type: PaymentTransaction | description: Wix Payments transaction. - name: transactionId | type: string | description: Wix Payments transaction GUID. - name: method | type: string | description: Transaction payment method, for example, "payPal", "creditCard", etc. - name: channel | type: ChannelType | description: Checkout channel type. - name: updated | type: string | description: Date and time the order was last updated. - name: marketingConsent | type: boolean | description: Whether marketing consent was given. - name: calendarLinks | type: CalendarLinks | description: "Add to calendar" links. - name: google | type: string | description: "Add to Google calendar" URL. - name: ics | type: string | description: "Download ICS calendar file" URL. ``` ### Examples ### GetOrder ```curl ~~~cURL curl -X GET 'https://api.wix.com/events/v1/events/619d52c0-c93b-4155-a55c-108048f20b3f/orders/FM9X-EHKF-ZO?fieldset=DETAILS&fieldset=FORM&fieldset=TICKETS' \ -H 'Authorization: ' ~~~ ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.ticketing.OrderManagement.getOrder(identifiers, options) Description: Retrieves an order, including ticket data. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: identifiers.eventId, identifiers.orderNumber, identifiers Method parameters: param name: identifiers | type: GetOrderIdentifiers none | required: true - name: eventId | type: string | description: Event GUID to which the order belongs. | required: true - name: orderNumber | type: string | description: Unique order number. | required: true param name: options | type: GetOrderOptions none - name: fieldset | type: array | description: Which fields to return. - enum: - TICKETS: Returns `tickets`. - DETAILS: Returns `archived`, `confirmed`, `created`, `firstName`, `fullName`, `lastName`, `method`, `reservationId`, `snapshotId`, `status`, `ticketsPdf`, `ticketsQuantity`, `totalPrice`. - FORM: Returns `checkoutForm`. - INVOICE: Returns `invoice`. Return type: PROMISE - name: orderNumber | type: string | description: Unique order number. - name: reservationId | type: string | description: Reservation GUID. - name: snapshotId | type: string | description: Payment snapshot GUID. Empty if `status` of the order is `"FREE"`. - name: eventId | type: string | description: Event GUID to which the order belongs. - name: contactId | type: string | description: Contact GUID of buyer, resolved using the email address specified. See the Contacts API for additional information. - name: memberId | type: string | description: Buyer member GUID, if applicable. See the Members API for additional information. - name: created | type: Date | description: Date and time the order was created. - name: firstName | type: string | description: Guest first name. - name: lastName | type: string | description: Guest last name. - name: email | type: string | description: Guest email address. - name: checkoutForm | type: FormResponse | description: Checkout form response. When each purchased ticket is assigned to a guest, guest forms are returned for each ticket, and buyer info is returned. - name: inputValues | type: array | description: Form field inputs. - name: inputName | type: string | description: Form field input name. - name: value | type: string | description: Form field value. - name: values | type: array | description: Form field values. - name: confirmed | type: boolean | description: Whether the order is confirmed. Triggered once the payment gateway processes the payment and funds reach the merchant's account. - name: status | type: OrderStatus | description: Order status. - enum: - NA_ORDER_STATUS: Order status isn't available for this request fieldset. - FREE: Order is confirmed, no payment is required. - PENDING: Order was paid, but the payment gateway suspended the payment. - PAID: Order is paid. - OFFLINE_PENDING: Order is confirmed but must be paid via offline payment. Status needs to be manually updated to `"PAID"`. - INITIATED: Order is waiting for payment at the cashier. - CANCELED: Order is canceled. - DECLINED: Order payment is declined. - AUTHORIZED: Order payment is authorized. - VOIDED: Order payment is voided. - PARTIALLY_PAID: Order is partially paid with less than the total amount. - name: method | type: string | description: Payment method used for purchase, for example, "payPal", "creditCard", etc. - name: ticketsQuantity | type: integer | description: Amount of tickets ordered. - name: totalPrice | type: Money | description: Total order price. - name: currency | type: string | description: 3-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. For example, `USD`. - name: value | type: string | description: Monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99). Optionally, starts with a single (-), to indicate that the amount is negative. - name: ticketsPdf | type: string | description: Ticket PDF URL. - name: tickets | type: array | description: Tickets (generated after payment). - name: ticketNumber | type: string | description: Unique ticket number which is assigned automatically when creating a ticket. - name: orderNumber | type: string | description: Associated order number. - name: ticketDefinitionId | type: string | description: Ticket definition GUID. See the Ticket Definition API for additional information. - name: name | type: string | description: Ticket type. - name: price | type: Money | description: Ticket price. - name: free | type: boolean | description: Whether the ticket requires payment. - name: policy | type: string | description: Ticket and event policies. - name: checkIn | type: CheckIn | description: Ticket check-in. - name: created | type: Date | description: Time of a ticket's check-in. - name: orderStatus | type: OrderStatus | description: Associated order status. - name: orderArchived | type: boolean | description: Whether the order and ticket are archived. If set to `true`, they aren't visible in the order list. - name: orderFullName | type: string | description: Buyer full name. - name: guestFullName | type: string | description: Guest full name. - name: guestDetails | type: GuestDetails | description: Guest personal details. - name: guestAssigned | type: boolean | description: Whether ticket belongs to assigned guest. - name: firstName | type: string | description: Guest first name. - name: lastName | type: string | description: Guest last name. - name: email | type: string | description: Guest email. - name: form | type: FormResponse | description: Full form response. - name: contactId | type: string | description: Contact GUID associated with this guest. - name: phone | type: string | description: Guest phone number. - name: archived | type: boolean | description: Whether the ticket is visible in an order. - name: memberId | type: string | description: Ticket owner member GUID. - name: anonymized | type: boolean | description: Whether ticket was anonymized by GDPR delete. Anonymized tickets no longer contain personally identifiable information (PII). - name: checkInUrl | type: string | description: Ticket check-in URL. Shown as QR code image in PDF.
Format: `"https://www.wixevents.com/check-in/{ticket number},{event id}"`
Example: `"https://www.wixevents.com/check-in/AAAA-AAAA-BB021,00000000-0000-0000-0000-000000000000"` - name: ticketPdfUrl | type: string | description: URL for ticket PDF download. - name: channel | type: ChannelType | description: Associated order checkout channel type. - enum: - ONLINE: Buyer created the order via an online channel, such as a website or mobile app. - OFFLINE_POS: Sales person created the order and collected the money. - name: walletPassUrl | type: string | description: URL to download a ticket in `.pkpass` format for Apple Wallet. - name: canceled | type: boolean | description: Whether ticket is canceled. - name: archived | type: boolean | description: Whether the order is archived. - name: anonymized | type: boolean | description: Whether the order is anonymized by GDPR delete. - name: fullName | type: string | description: Guest full name. - name: invoice | type: Invoice | description: Order invoice. - name: items | type: array | description: - name: _id | type: string | description: Unique line item GUID. - name: quantity | type: integer | description: Line item quantity. - name: name | type: string | description: Line item name. - name: price | type: Money | description: Line item price. - name: total | type: Money | description: Total price for line items. Always equal to price * quantity. - name: discount | type: Discount | description: Discount applied to the line item. - name: amount | type: Money | description: Total discount amount. - name: afterDiscount | type: Money | description: Total sum after the discount. - name: discounts | type: array | description: Discount items. - ONE-OF: - name: coupon | type: CouponDiscount | description: Coupon discount. - name: name | type: string | description: Discount coupon name. **Deprecated:** Use `invoice.discounts.coupon.name` instead. - name: code | type: string | description: Discount coupon code. **Deprecated:** Use `invoice.discounts.coupon.code` instead. - name: couponId | type: string | description: Discount coupon GUID. **Deprecated:** Use `invoice.discounts.coupon.couponId` instead. - name: paidPlan | type: PaidPlanDiscount | description: Pricing plan discount. - ONE-OF: - name: percentDiscount | type: PercentDiscount | description: Discount by percentage applied to tickets. - name: rate | type: string | description: Percent rate. - name: quantityDiscounted | type: integer | description: Number of discounted tickets. - name: name | type: string | description: Name of pricing plan. - name: amount | type: Money | description: Total discount amount. - name: tax | type: Tax | description: Tax applied to the item. - name: type | type: TaxType | description: Tax type. - enum: - INCLUDED: Tax is included in the ticket price. - ADDED: Tax is added to the order at the checkout. - ADDED_AT_CHECKOUT: Tax is added to the final total at the checkout. - name: name | type: string | description: Tax name. - name: rate | type: string | description: Tax rate. - name: taxable | type: Money | description: Taxable amount. - name: amount | type: Money | description: Total tax amount. - name: fees | type: array | description: Fees applied to the item. - name: name | type: FeeName | description: Fee identifier. - enum: - WIX_FEE: Wix ticket service fee charges applied to the line item. - name: type | type: FeeType | description: How fee is calculated. - enum: - FEE_ADDED: Fee is added to the ticket price at checkout. - FEE_INCLUDED: Seller absorbs the fee. It's deducted from the ticket price. - FEE_ADDED_AT_CHECKOUT: Fee is added to the ticket price at checkout. - name: rate | type: string | description: Fee rate. - name: amount | type: Money | description: Total amount of fee charges. - name: discount | type: Discount | description: Discount applied to a cart. - name: tax | type: Tax | description: Tax applied to a cart. - name: subTotal | type: Money | description: Total cart amount before discount, tax, and fees. - name: grandTotal | type: Money | description: Total amount of a cart after discount, tax, and fees. Grand total is calculated in the following order: 1. Total prices of all items in the cart are calculated. 2. Discount is subtracted from the cart, if applicable. 3. Tax is added, if applicable. 4. Wix ticket service fee is added. - name: fees | type: array | description: Fees applied to the cart. - name: revenue | type: Money | description: Total revenue, excluding fees. Taxes and payment provider fees aren't deducted. - name: previewUrl | type: string | description: Invoice preview URL. Only returned if the order is paid. - name: fullyCheckedIn | type: boolean | description: Whether all tickets in an order are checked in. - name: paymentDetails | type: PaymentDetails | description: Internal order payment details. - name: transaction | type: PaymentTransaction | description: Wix Payments transaction. - name: transactionId | type: string | description: Wix Payments transaction GUID. - name: method | type: string | description: Transaction payment method, for example, "payPal", "creditCard", etc. - name: channel | type: ChannelType | description: Checkout channel type. - name: updated | type: Date | description: Date and time the order was last updated. - name: marketingConsent | type: boolean | description: Whether marketing consent was given. ``` ### Examples ### getOrder ```javascript import { orders } from '@wix/events'; async function getOrder(identifiers,options) { const response = await orders.getOrder(identifiers,options); }; ``` ### getOrder (with elevated permissions) ```javascript import { orders } from '@wix/events'; import { auth } from '@wix/essentials'; async function myGetOrderMethod(identifiers,options) { const elevatedGetOrder = auth.elevate(orders.getOrder); const response = await elevatedGetOrder(identifiers,options); } ``` ### getOrder (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { orders } from '@wix/events'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { orders }, // Include the auth strategy and host as relevant }); async function getOrder(identifiers,options) { const response = await myWixClient.orders.getOrder(identifiers,options); }; ``` ---