# Registration Order

## Create a ticketing order

> Creates an order with validation of registration form and ticketing constraints, promo code resolution, and optionally a Stripe payment intent. Returns the order with its payment secret and add-on selection statuses.

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"name":"Authorization","type":"apiKey","in":"header","description":"Bearer Authorization with jwt token"}}},"paths":{"/public-api/v1/reg/event/{eventId}":{"post":{"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"paymentSecret":{"type":"string"},"status":{"type":"string","enum":["initialized","pending_payment","paid","cancelled","completed","refunding","refunded"]},"orderItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"addOns":{"type":"array","items":{"type":"object","properties":{"ticketClassAddOnId":{"type":"string","format":"uuid"},"selectionStatus":{"type":"string","enum":["regular","waitlisted","confirmed"]}},"required":["ticketClassAddOnId","selectionStatus"],"additionalProperties":false}}},"required":["id","addOns"],"additionalProperties":false}}},"required":["id","status","orderItems"],"additionalProperties":false}},"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"500":{"description":"ERROR"}},"parameters":[{"schema":{"type":"string","format":"uuid"},"name":"eventId","in":"path"}],"tags":["Registration Order"],"operationId":"createOrder","summary":"Create a ticketing order","description":"Creates an order with validation of registration form and ticketing constraints, promo code resolution, and optionally a Stripe payment intent. Returns the order with its payment secret and add-on selection statuses.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"purchaserEmail":{"type":"string"},"attendeeTicketOrderItems":{"type":"array","items":{"type":"object","properties":{"ticketClassId":{"type":"string"},"regFormData":{"type":"object","properties":{"email":{"type":"string","format":"email"},"regFormId":{"type":"string"},"rsvpToken":{"type":"string","format":"uuid"},"eventProspectId":{"type":"string","format":"uuid"},"magicLinkToken":{"type":"string","format":"uuid"},"fields":{"type":"object","properties":{},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"boolean"},{"type":"object","properties":{"mediaValues":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}]}}},"required":["fields"],"additionalProperties":false},"addOnIds":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["ticketClassId"],"additionalProperties":false}},"stripePaymentMethod":{"type":"string","enum":["card","alipay","apple_pay","google_pay"]},"promoCodeName":{"type":"string"},"orderPaymentMethod":{"type":"string","enum":["online","offline"]},"offlinePaymentBillingInformation":{"type":"string"},"paymentBillingInformation":{"type":"string"},"customUtmParams":{"type":"object","properties":{},"additionalProperties":false},"utm_source":{"type":"string"},"utm_medium":{"type":"string"},"utm_campaign":{"type":"string"},"utm_term":{"type":"string"},"utm_content":{"type":"string"}},"required":["purchaserEmail"],"additionalProperties":false}}}}}}}}
```

## GET /public-api/v1/reg/event/{eventId}/{orderId}/status

> Get the status of an order

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"name":"Authorization","type":"apiKey","in":"header","description":"Bearer Authorization with jwt token"}}},"paths":{"/public-api/v1/reg/event/{eventId}/{orderId}/status":{"get":{"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["initialized","pending_payment","paid","cancelled","completed","refunding","refunded"]}},"required":["id","status"],"additionalProperties":false}},"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"500":{"description":"ERROR"}},"parameters":[{"schema":{"type":"string","format":"uuid"},"name":"eventId","in":"path"},{"schema":{"type":"string","format":"uuid"},"name":"orderId","in":"path"}],"tags":["Registration Order"],"operationId":"getOrderStatus","summary":"Get the status of an order"}}}}
```

## Get a price quotation without creating an order

> Returns line-item pricing for the requested tickets and add-ons, including promo code discounts if applicable. No order is created. Use this to preview pricing before placing an order.

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"name":"Authorization","type":"apiKey","in":"header","description":"Bearer Authorization with jwt token"}}},"paths":{"/public-api/v1/reg/event/{eventId}/quotation":{"post":{"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"totalAmount":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"ticketClassId":{"type":"string","format":"uuid"},"unitPrice":{"type":"string"},"qty":{"type":"number","format":"float"},"actualPrice":{"type":"string"},"actualTicketPrice":{"type":"string"},"originalPrice":{"type":"string"},"appliedPromoCode":{"type":"string"},"addOns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"price":{"type":"string"}},"required":["id","price"],"additionalProperties":false}}},"required":["ticketClassId","unitPrice","qty","actualPrice","actualTicketPrice","originalPrice"],"additionalProperties":false}},"minCharge":{"type":"number","format":"float"}},"required":["totalAmount","minCharge"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"500":{"description":"ERROR"}},"parameters":[{"schema":{"type":"string","format":"uuid"},"name":"eventId","in":"path"}],"tags":["Registration Order"],"operationId":"getOrderQuotation","summary":"Get a price quotation without creating an order","description":"Returns line-item pricing for the requested tickets and add-ons, including promo code discounts if applicable. No order is created. Use this to preview pricing before placing an order.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"orderItems":{"type":"array","items":{"type":"object","properties":{"ticketClassId":{"type":"string","format":"uuid"},"qty":{"type":"number","format":"float","minimum":1},"addOnIds":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["ticketClassId","qty"],"additionalProperties":false}},"promoCode":{"type":"string"}},"additionalProperties":false}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://eventx-hq.gitbook.io/knowledge-base/api-doc/registration-order.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.