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

# Entitlements

> The firm-wide directory of every user's market-data entitlements - one row per user and exchange.

The **Entitlements** tab is the firm-wide directory of every user's market-data entitlements - the view layer that shows who is authorized for which exchange. As an admin you can see each customer's email and the entitlements on their account.

> [!NOTE]
>
> **Where it lives:** Sidebar → **Tickblaze Manager** → **Entitlements**.

![Entitlements tab](https://mintcdn.com/tbignite/OlHmB8MlUnxshCJj/images/entitlements/initial-view.png?fit=max\&auto=format\&n=OlHmB8MlUnxshCJj\&q=85\&s=e743f86993314c136fe9863207147de9)

The Entitlements tab - one row per user and exchange, with status, status date, and data level.

## What the grid shows

There is **one row per user and exchange**. A user entitled to several exchanges appears on several rows.

| Column | Meaning |
| - | - |
| User | The customer's email. |
| Entitlements | The exchange - **CBOT, CME, COMEX, NYMEX** (futures) or **Nasdaq** (stocks). |
| Status | **Authorized**, **Revoked**, or **Pending** - change it from the dropdown on the row (see below). |
| Status date | When the status was last updated. |
| Level | The data level - **L1** (Level 1, top-of-book: the best bid and ask and the last trade.) or **L2** (Level 2, depth-of-book: the full order book beyond the best bid and ask.). |

**Filters** above the table: **Search by email**, a **LEVEL** filter (**L1** / **L1 + L2**), and an **All entitlements** dropdown to filter by exchange.

## Status meanings

| Status | What it means |
| - | - |
| **Authorized** | The user has access to that exchange's market data at their entitled level (L1 or L2) - they receive it on the charts and can trade. |
| **Pending** | The user has logged in or purchased an account but hasn't yet selected **Pro / Non-Pro** and hasn't received the exchange entitlement (Permission for one user to receive a particular exchange's market data.). Once it's granted, the entitlement requirement is met - the user can trade provided they are also Enabled, not Blocked, and hold an active tradable account (see [Status definitions](https://tbignite.mintlify.site/status-definitions.md)). Status date shows `—` until it resolves. |
| **Revoked** | The user no longer has access to that exchange's market data. |

![Pending entitlements](https://mintcdn.com/tbignite/OlHmB8MlUnxshCJj/images/entitlements/pending.png?fit=max\&auto=format\&n=OlHmB8MlUnxshCJj\&q=85\&s=f3e30d2b1392aa28a36cd7b1bcf804c6)

Pending entitlements - awaiting the user's Pro/Non-Pro selection and the exchange grant.

## The entitlement lifecycle

Most entitlements move through these states on their own - you only step in when one is stuck.

```mermaid theme={null}
stateDiagram-v2
    [*] --> Pending: account created / first login
    Pending --> Authorized: Pro / Non-Pro selected, entitlement granted
    Authorized --> Revoked: access removed
    Revoked --> Authorized: manual re-authorization
```

## Where entitlements come from

This tab is the **view layer**. Entitlements are granted at the **challenge (The evaluation program an account is created under - its starting balance, profit target, and risk rules.) level** - the [Challenges](https://tbignite.mintlify.site/challenges.md) → Configuration → **Market data entitlements** section sets them for accounts created under that challenge. This tab shows the resulting per-user state across the firm.

> [!NOTE]
>
> **Cross-firm:** the Pro/Non-Pro classification propagates across all Tickblaze partner firms - the same rule as the **Type of user** column on [Users](https://tbignite.mintlify.site/users.md). Entitlements themselves are granted per challenge and remain firm-specific.

## Changing a status manually

Each row's **Status** is a dropdown you can use to change it.

> [!WARNING]
>
> **Authorizing a user starts billing them.** A user is billable whenever they hold an **Authorized** entitlement - **Revoked** and **Pending** do not bill. That is true regardless of whether they ever trade, and regardless of whether their user record is Disabled. To stop billing a user, **revoke the entitlement**; disabling them is not enough. Note that billing runs by whole calendar month and is **not prorated** - revoking today stops the charge from **next** month, not from today. See [Billing](https://tbignite.mintlify.site/billing.md).

* **Pending usually resolves on its own** - once the user selects Pro/Non-Pro and receives the entitlement, it becomes Authorized. You rarely authorize a pending user by hand, but you **can** if they're stuck and not receiving the market data.
* **Revoked → Authorized** - you can manually re-authorize a revoked user to restore their market data.

> [!WARNING]
>
> Manual authorization is an override - use it only when the normal flow is stuck.

## Related

* [Billing](https://tbignite.mintlify.site/billing.md) - why an Authorized entitlement is what makes a user billable.
* [Users](https://tbignite.mintlify.site/users.md) - the Trading status and Market data entitlements columns.
* [Edit user](https://tbignite.mintlify.site/edit-user.md) - the per-user Entitlements card (same Authorized / Revoked / Pending states).
* [Glossary](https://tbignite.mintlify.site/glossary.md) - definitions for L1, L2, and Pro vs Non-Pro.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.