---
title: "Return the user's Nova tier snapshot"
method: GET
path: "/Nova/get_tier"
tags: ["Nova"]
---

# Return the user's Nova tier snapshot

`GET /Nova/get_tier`

## Request

- Base URL: `https://cpanel-server.tld:2083/execute`
- URL: `https://cpanel-server.tld:2083/execute/Nova/get_tier`
- Auth: HTTP basic

This function returns the cPanel user's AI App Builder (Nova) tier snapshot for tier display and upsell.

**Notes:**

  * This function **requires** that your package includes the AI App Builder feature.
  * The Meridian theme gates the Nova interface on the `nova` feature itself; this read-only call only feeds tier-aware display.

## Response `200`

HTTP Request was successful.

- object
  - `apiversion` integer: The version of the API.
  - `func` string: The name of the method called.
  - `module` string: The name of the module called.
  - `result` object
    - `data` object: The user's Nova tier snapshot.
      - `tier` string: The user's effective AI App Builder tier (the AI_APP_BUILDER_TIER value from the cpuser file), or an empty string if none.
      - `account_exists` 1 | 0: Whether the user has been provisioned on Nova. * `1` - The user has a Nova account. * `0` - The user does not have a Nova account.
    - `errors` string[], nullable: List of errors if the API failed.
    - `messages` string[], nullable: List of messages generated by the API.
    - `metadata` object
      - `transformed` 1: Post-processing may have transformed the data.
    - `status` 1 | 0: - `1` - Success. - `0` - Failed: Check the errors field for more details.
    - `warnings` string[], nullable: List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running an API.

## Changes

- **2026-09-24** `64a55c1ebd37`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cpanel/apis/cpanel-uapi/changes/Nova/get_tier/get.md)

---

[API](https://skmtc.dev/cpanel/apis/cpanel-uapi.md) - [All operations](https://skmtc.dev/cpanel/apis/cpanel-uapi/llms.txt) - [OpenAPI document](https://skmtc.dev/cpanel/apis/cpanel-uapi/revisions/05239220da37?raw)