Registration Order

Create a ticketing order

post

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.

Authorizations

AuthorizationstringRequired

Bearer Authorization with jwt token

Path parameters

eventIdstring · uuidRequired

Body

purchaserEmailstringRequired

stripePaymentMethodstring · enumOptionalPossible values:

promoCodeNamestringOptional

orderPaymentMethodstring · enumOptionalPossible values:

offlinePaymentBillingInformationstringOptional

paymentBillingInformationstringOptional

customUtmParamsobjectOptional

utm_sourcestringOptional

utm_mediumstringOptional

utm_campaignstringOptional

utm_termstringOptional

utm_contentstringOptional

Responses

200

Success

application/json

500

ERROR

post/public-api/v1/reg/event/{eventId}

POST /public-api/v1/reg/event/{eventId} HTTP/1.1
Host: esaas-api.eventx.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 680

{
  "purchaserEmail": "text",
  "attendeeTicketOrderItems": [
    {
      "ticketClassId": "text",
      "regFormData": {
        "email": "[e-mail]",
        "regFormId": "text",
        "rsvpToken": "123e4567-e89b-12d3-a456-426614174000",
        "eventProspectId": "123e4567-e89b-12d3-a456-426614174000",
        "magicLinkToken": "123e4567-e89b-12d3-a456-426614174000",
        "fields": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "addOnIds": [
        "123e4567-e89b-12d3-a456-426614174000"
      ]
    }
  ],
  "stripePaymentMethod": "card",
  "promoCodeName": "text",
  "orderPaymentMethod": "online",
  "offlinePaymentBillingInformation": "text",
  "paymentBillingInformation": "text",
  "customUtmParams": {},
  "utm_source": "text",
  "utm_medium": "text",
  "utm_campaign": "text",
  "utm_term": "text",
  "utm_content": "text"
}

{
  "data": {
    "order": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "paymentSecret": "text",
      "status": "initialized",
      "orderItems": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "addOns": [
            {
              "ticketClassAddOnId": "123e4567-e89b-12d3-a456-426614174000",
              "selectionStatus": "regular"
            }
          ]
        }
      ]
    }
  }
}

Get the status of an order

get

Authorizations

AuthorizationstringRequired

Bearer Authorization with jwt token

Path parameters

eventIdstring · uuidRequired

orderIdstring · uuidRequired

Responses

200

Success

application/json

500

ERROR

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

GET /public-api/v1/reg/event/{eventId}/{orderId}/status HTTP/1.1
Host: esaas-api.eventx.io
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "order": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "initialized"
    }
  }
}

Get a price quotation without creating an order

post

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.

Authorizations

AuthorizationstringRequired

Bearer Authorization with jwt token

Path parameters

eventIdstring · uuidRequired

Body

promoCodestringOptional

Responses

200

Success

application/json

500

ERROR

post/public-api/v1/reg/event/{eventId}/quotation

POST /public-api/v1/reg/event/{eventId}/quotation HTTP/1.1
Host: esaas-api.eventx.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 152

{
  "orderItems": [
    {
      "ticketClassId": "123e4567-e89b-12d3-a456-426614174000",
      "qty": 1,
      "addOnIds": [
        "123e4567-e89b-12d3-a456-426614174000"
      ]
    }
  ],
  "promoCode": "text"
}

{
  "data": {
    "totalAmount": "text",
    "items": [
      {
        "ticketClassId": "123e4567-e89b-12d3-a456-426614174000",
        "unitPrice": "text",
        "qty": 1,
        "actualPrice": "text",
        "actualTicketPrice": "text",
        "originalPrice": "text",
        "appliedPromoCode": "text",
        "addOns": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "price": "text"
          }
        ]
      }
    ],
    "minCharge": 1
  }
}