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

# premium_required

> Endpoint or tool requires a plan that includes premium endpoints

export const BillingLink = ({children}) => {
  return <a href="https://platform.particle.pro/billing">{children}</a>;
};

|                    |                        |
| ------------------ | ---------------------- |
| **HTTP status**    | `402 Payment Required` |
| **Error code**     | `premium_required`     |
| **Resolve action** | `upgrade_plan`         |

## What happened

The organization called a **premium-tier** endpoint or MCP tool — for example Ad
Intelligence, Publisher Landscape, or Brand Safety & Suitability — on a plan that
does not include premium endpoints.

Premium endpoints are available to every new organization while its one-time
signup credit is funding usage. Once that credit is depleted and the
subscription converts to its paid phase, premium access continues only on plans
whose definition includes premium endpoints (for example Business). Plans
without premium endpoints (for example Team) lose premium access at that point.

## How to fix

Upgrade to a plan that includes premium endpoints via the platform UI's
<BillingLink>billing page</BillingLink>, or change the plan directly:

```
PUT /v1/organizations/{org_id}/billing/subscription
{
  "plan_id": "business"
}
```

After the upgrade takes effect, retry the original request.