---
title: "SubscriptionPlan"
description: "the limits a tenant receives, each a parameter of the receive family, and its kind: trial, paid or internal; acquisition never reads it"
section: concepts
address: /concepts/subscriptionplan
contract: 0476e35e6e275db5
---

# SubscriptionPlan

the limits a tenant receives, each a parameter of the receive family, and its kind: trial, paid or internal; acquisition never reads it

[figure: SubscriptionPlan is a definition at tenant scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | definition |
| scope | tenant |
| key | the tenant and its dates |
| store | postgres |
| family | people |



## Fields


| field | type | required | note |
|---|---|---|---|
| `name` | `text` | yes |  |
| `tenant` | `id` | no | the tenant the plan limits; absent on a plan embedded in a tenant's row at sign-up |
| `leads_per_period` | `count` | yes | enforced at delivery, counted across the tenant's brands |
| `period` | `duration` | yes |  |
| `definitions_armed` | `count` | no |  |
| `starts_at` | `time` | yes |  |
| `ends_at` | `time` | no |  |
| `kind` | `one of trial \| paid \| internal` | yes |  |
| `ends` | `date` | no | a trial's end |



## Routes that use it
No route takes or returns SubscriptionPlan directly. The record holds it, and the objects that point at it reach it.