---
title: "High Level Schema Overview"
slug: "high-level-schema-overview"
updated: 2025-04-28T18:22:00Z
published: 2025-04-28T18:22:00Z
canonical: "developer.upgrade.com/high-level-schema-overview"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.upgrade.com/llms.txt
> Use this file to discover all available pages before exploring further.

# High Level Schema Overview

We have divided our schema into **different verticals** on the basis of the **different industries** that our partners operate in. Ensure to use the schema that is relevant to your business.

📌 Mandatory Fields

Note that the order object must include all its corresponding mandatory fields; the mandatory fields are highlighted in **bold** in the tables below.

⚠️ Note that billing_contact can be used on payment pages to pre-fill information in the Flex Pay application iFrame. Thus, while it is not required by any vertical with the exception of Retail, it is highly recommended to improve customer experience.

### Air

| Key | Type | Allowed Values | Description |
| --- | --- | --- | --- |
| **travelers** | [ PersonObject ] | [PersonObject](https://uplift-docs.document360.io/docs/resource-objects#personobject) | Traveler's personal details |
| **air_reservations** | [ AirReservationObject ] | [AirReservationObject](https://uplift-docs.document360.io/docs/resource-objects#airreservationobject) | Air reservation itinerary details |
| **add_ons** | [ AddOnObject ] | [AddOnObject](https://uplift-docs.document360.io/docs/resource-objects#addonobject) | Add on product details |
| **order_amount** | Integer | Non-negative, in Cents | Total price amount of order |
| billing_contact | CustomerContactObject | [CustomerContactObject](https://uplift-docs.document360.io/docs/resource-objects#customercontactobject) | Customer’s billing contact information |
| points | [ PointObject ] | [PointObject](https://uplift-docs.document360.io/docs/resource-objects#pointobject) | Points details (e.g. loyalty) |

### Hotel

| Key | Type | Allowed Values | Description |
| --- | --- | --- | --- |
| **travelers** | [ PersonObject ] | [PersonObject](https://uplift-docs.document360.io/docs/resource-objects#personobject) | Traveler's personal details |
| **hotel_reservations** | [ HotelReservationObject ] | [HotelReservationObject](https://uplift-docs.document360.io/docs/resource-objects#hotelreservationobject) | Hotel reservation itinerary details |
| **add_ons** | [ AddOnObject ] | [AddOnObject](https://uplift-docs.document360.io/docs/resource-objects#addonobject) | Add on product details |
| **order_amount** | Integer | Non-negative, in Cents | Total price amount of order |
| billing_contact | CustomerContactObject | [CustomerContactObject](https://uplift-docs.document360.io/docs/resource-objects#customercontactobject) | Customer’s billing contact information |
| points | [ PointObject ] | [PointObject](https://uplift-docs.document360.io/docs/resource-objects#pointobject) | Points details (e.g. loyalty) |

### Cruise

| Key | Type | Allowed Values | Description |
| --- | --- | --- | --- |
| **travelers** | [ PersonObject ] | [PersonObject](https://uplift-docs.document360.io/docs/resource-objects#personobject) | Traveler's personal details |
| **cruise_reservations** | [ CruiseReservationObject ] | [CruiseReservationObject](https://uplift-docs.document360.io/docs/resource-objects#cruisereservationobject) | Cruise reservation itinerary details |
| **add_ons** | [ AddOnObject ] | [AddOnObject](https://uplift-docs.document360.io/docs/resource-objects#addonobject) | Add on product details |
| **order_amount** | Integer | Non-negative, in Cents | Total price amount of order |
| billing_contact | CustomerContactObject | [CustomerContactObject](https://uplift-docs.document360.io/docs/resource-objects#customercontactobject) | Customer’s billing contact information |
| points | [ PointObject ] | [PointObject](https://uplift-docs.document360.io/docs/resource-objects#pointobject) | Points details (e.g. loyalty) |

### Retail

| Key | Type | Allowed Values | Description |
| --- | --- | --- | --- |
| **billing_contact** | CustomerContactObject | [CustomerContactObject](https://uplift-docs.document360.io/docs/resource-objects#customercontactobject) | Customer’s billing contact information |
| **shipping_contact** | CustomerContactObject | [CustomerContactObject](https://uplift-docs.document360.io/docs/resource-objects#customercontactobject) | Customer’s shipping contact information |
| **order_lines** | [ OrderLineObject ] | [OrderLineObject](https://uplift-docs.document360.io/docs/resource-objects#orderlineobject) | Order line details (such as quantity, sku, name etc.) |
| **order_amount** | Integer | Non-negative, in Cents | Total price amount of order |

### Event-Tickets

| Key | Type | Allowed Values | Description |
| --- | --- | --- | --- |
| **travelers** | [ PersonObject ] | [PersonObject](https://uplift-docs.document360.io/docs/resource-objects#personobject) | Customer's personal details |
| **event_tickets** | [ EventTicketObject ] | [EventTicketObject](https://uplift-docs.document360.io/docs/resource-objects#eventticketobject) | Event ticket details |
| **add_ons** | [ AddOnObject ] | [AddOnObject](https://uplift-docs.document360.io/docs/resource-objects#addonobject) | Add on product details |
| **order_amount** | Integer | Non-negative, in Cents | Total price amount of order |
| billing_contact | CustomerContactObject | [CustomerContactObject](https://uplift-docs.document360.io/docs/resource-objects#customercontactobject) | Customer’s billing contact information |
| points | [ PointObject ] | [PointObject](https://uplift-docs.document360.io/docs/resource-objects#pointobject) | Points details (e.g. loyalty) |

### Rentals

| Key | Type | Allowed Values | Description |
| --- | --- | --- | --- |
| **travelers** | [ PersonObject ] | [PersonObject](https://uplift-docs.document360.io/docs/resource-objects#personobject) | Traveler's personal details |
| **rentals** | [ RentalObject ] | [RentalObject](https://uplift-docs.document360.io/docs/resource-objects#rentalobject) | Rental agreement details |
| **add_ons** | [ AddOnObject ] | [AddOnObject](https://uplift-docs.document360.io/docs/resource-objects#addonobject) | Add on product details |
| **order_amount** | Integer | Non-negative, in Cents | Total price amount of order |
| billing_contact | CustomerContactObject | [CustomerContactObject](https://uplift-docs.document360.io/docs/resource-objects#customercontactobject) | Customer’s billing contact information |
| points | [ PointObject ] | [PointObject](https://uplift-docs.document360.io/docs/resource-objects#pointobject) | Points details (e.g. loyalty) |

### Passes-Subscription

| Key | Type | Allowed Values | Description |
| --- | --- | --- | --- |
| **travelers** | [ PersonObject ] | [PersonObject](https://uplift-docs.document360.io/docs/resource-objects#personobject) | Traveler's personal details |
| **passes_subscription** | [ PassesSubscriptionObject ] | [PassesSubscriptionObject](https://docs.uplift.com/docs/resource-objects#passessubscriptionobject) | Pass/Subscription details |
| **add_ons** | [ AddOnObject ] | [AddOnObject](https://uplift-docs.document360.io/docs/resource-objects#addonobject) | Add on product details |
| **order_amount** | Integer | Non-negative, in Cents | Total price amount of order |
| billing_contact | CustomerContactObject | [CustomerContactObject](https://uplift-docs.document360.io/docs/resource-objects#customercontactobject) | Customer’s billing contact information |