---
title: "PriceLadder"
description: "the tenant's tiers in order with the study that set them; extends the price list, whose version in force the metering reads; a change is a new version"
section: concepts
address: /concepts/priceladder
contract: 0476e35e6e275db5
---

# PriceLadder

the tenant's tiers in order with the study that set them; extends the price list, whose version in force the metering reads; a change is a new version

[figure: PriceLadder is a row at platform scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | row |
| scope | platform |
| key | its version |
| store | postgres |
| family | market |



## Fields


| field | type | required | note |
|---|---|---|---|
| `version` | `count` | yes |  |
| `from` | `date` | yes | the date it is in force from |
| `tiers` | [PriceTier](/concepts/pricetier) | yes |  |
| `price_list` | `id` | yes | the price list version the tiers price their metered usage from |
| `study` | `id` | yes | the pricing study that set it |
| `state` | [Readiness](/concepts/readiness) | yes | not ready when a tier has no offering or no allowance, or the study is absent |



## Routes that use it
- [`/v1/economics/ladder`](/reference/economics/ladder) returns it