# Return the user's Nova tier snapshot

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.

Endpoint: GET /Nova/get_tier
Version: 11.138.0.10
Security: BasicAuth

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "get_tier"

  - `module` (string)
    The name of the module called.
    Example: "Nova"

  - `result` (object)

  - `result.data` (object)
    The user's Nova tier snapshot.

  - `result.data.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.
    Example: "free"

  - `result.data.account_exists` (integer)
    Whether the user has been provisioned on Nova.
  * 1 - The user has a Nova account.
  * 0 - The user does not have a Nova account.
    Enum: 1, 0

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.metadata.transformed` (integer)
    Post-processing may have transformed the data.
    Enum: 1

  - `result.status` (integer)
    - 1 - Success.
- 0 - Failed: Check the errors field for more details.
    Enum: 1, 0

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running an API.