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

# Tiers

> Use tiers to define your pricing.

Each `tiers` element represents a pricing tier in your product.

## The tier model

Use it to define each pricing tier individually.

If your product doesn't have tiers, it's a single-tier product. Set `up_to` to `NULL`.

Use `unit_amount` when you charge per unit. For example, "User based pricing", \$10/user.

Use `flat_amount` when you charge one total cost for a given subscription, for example, "Premium plan", that has prices for $20/month, $200/year.

### Properties

| Name | Type | Required | Description |
| - | - | - | - |
| `unit_amount` | `integer` | Yes | Per unit price for units relevant to the tier. |
| `flat_amount` | `integer` | Yes | Price for the entire tier. |
| `up_to` | `integer` | Yes | Up to and including to this quantity will be contained in the tier. |


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