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

# Subscription & Pricing

> Configure platform-level pricing tiers, usage-based billing charges, free allowances, and API rate limits for organizations.

## Overview

**Subscription & Pricing** is an admin-level feature that controls how organizations are billed for their use of the Pingtree platform. Admins can define base costs, configure usage-based charges per event type, set free tier allowances, and enforce API rate limits on a per-organization basis.

> **Note:** This section is restricted to platform administrators. Organization users do not have access to these settings.

***

## Price Settings

Price settings define the foundational billing structure applied to an organization's subscription.

### Base Cost Options

| Field                         | Description                                                         |
| ----------------------------- | ------------------------------------------------------------------- |
| **Base Cost**                 | The flat monthly cost charged to the organization (up to \$100,000) |
| **Managed Service Base Cost** | An additional flat fee for organizations on a managed service plan  |

### Trial Options

Control how the trial period is structured before the organization is charged:

| Field                   | Description                                                                                        |
| ----------------------- | -------------------------------------------------------------------------------------------------- |
| **Cost Structure**      | Choose the pricing model — `Manual` (default) or `Straight Cost` (immediate billing with no trial) |
| **Trial Days**          | Number of days the organization has access before billing begins (max 1,000 days)                  |
| **Require Credit Card** | When enabled, a valid credit card must be on file before the trial begins                          |

> When **Straight Cost** is selected as the cost structure, trial day and credit card settings are not applicable.

***

## Usage-Based Billing

Usage-based billing allows the platform to charge organizations incrementally based on their actual activity. Each billable event type can be configured with a per-unit cost.

### Billable Event Types

| Event Type       | Description                                               |
| ---------------- | --------------------------------------------------------- |
| **Leads**        | Charged per lead submitted through the platform           |
| **Webhooks**     | Charged per outbound webhook fired to a buyer or endpoint |
| **Pings**        | Charged per ping sent in a ping-post distribution flow    |
| **Lead Fetches** | Charged per lead retrieval via the lead fetch API         |

### Free Tier Allowances

Each event type can include a free tier — a number of events that are not billed within a billing cycle. Once the free tier is exhausted, the per-unit charge applies to all subsequent events.

| Setting               | Description                                               |
| --------------------- | --------------------------------------------------------- |
| **Free Leads**        | Number of leads included at no charge each billing period |
| **Free Webhooks**     | Number of webhook events included at no charge            |
| **Free Pings**        | Number of ping events included at no charge               |
| **Free Lead Fetches** | Number of lead fetch events included at no charge         |

> Usage-based billing can be toggled on or off per organization. When disabled, only the flat base cost applies. This toggle is also accessible from **Settings > Account Settings**.

***

## Rate Limit Management

Rate limits control how many API requests an organization can make within a given time window. Setting appropriate rate limits prevents abuse and ensures fair resource allocation across the platform.

### Configurable Rate Limits

Rate limits are set per API endpoint category and can be adjusted independently for each organization:

| Limit Type                     | Description                                         |
| ------------------------------ | --------------------------------------------------- |
| **Click API Rate Limit**       | Maximum click events accepted per time window       |
| **Form / Lead API Rate Limit** | Maximum lead submissions accepted per time window   |
| **Ping API Rate Limit**        | Maximum ping requests accepted per time window      |
| **Webhook Rate Limit**         | Maximum outbound webhook dispatches per time window |

### How Rate Limiting Works

When an organization exceeds its configured rate limit for a given API, subsequent requests within the same window are rejected with an HTTP `429 Too Many Requests` response. Requests resume normally once the window resets.

> Rate limit windows are rolling and are enforced at the organization level. Individual campaigns within an organization share the organization's rate limit allocation.

***

## Billing Tier Summary

The table below summarizes how the different billing components interact:

| Component                 | Applies When                                                              |
| ------------------------- | ------------------------------------------------------------------------- |
| Base Cost                 | Always — charged at the start of each billing cycle                       |
| Managed Service Base Cost | Only for organizations on a managed service plan                          |
| Free Tier                 | Deducted first before any per-unit usage charges apply                    |
| Per-Unit Usage Charges    | Applied after free tier is exhausted, when usage-based billing is enabled |
| Rate Limits               | Enforced continuously regardless of billing model                         |