> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Plans Entity

> Know about the Plan entity and the associated parameter descriptions.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
  <span>🇸🇬 Singapore</span>
  <span>🇺🇸 United States</span>
</div>

The Plans entity has the following parameters.

<ResponseExample>
  ```json Entity theme={null}
  {
    "entity":"collection",
    "count":2,
    "items":[
      {
        "id":"plan_00000000000008",
        "entity":"plan",
        "interval":1,
        "period":"weekly",
        "item":{
          "id":"item_00000000000005",
          "active":true,
          "name":"Test plan - Monthly",
          "description":"Description for the test plan - Monthly",
          "amount":89900,
          "unit_amount":89900,
          "currency":"USD",
          "type":"plan",
          "unit":null,
          "tax_inclusive":false,
          "hsn_code":null,
          "sac_code":null,
          "tax_rate":null,
          "tax_id":null,
          "tax_group_id":null,
          "created_at":1580220461,
          "updated_at":1580220481
        },
        "notes":{
          "notes_key_1":"Tea, Earl Grey, Hot",
          "notes_key_2":"Tea, Earl Grey… decaf."
        },
        "created_at":1580220481
      },
      {
        "id":"plan_00000000000009",
        "entity":"plan",
        "interval":1,
        "period":"monthly",
        "item":{
          "id":"item_00000000000002",
          "active":true,
          "name":"Test plan - Annual",
          "description":null,
          "amount":79900,
          "unit_amount":79900,
          "currency":"USD",
          "type":"plan",
          "unit":null,
          "tax_inclusive":false,
          "hsn_code":null,
          "sac_code":null,
          "tax_rate":null,
          "tax_id":null,
          "tax_group_id":null,
          "created_at":1580220493,
          "updated_at":1580220493
        },
        "notes":[
          
        ],
        "created_at":1580220493
      }
    ]
  }
  ```
</ResponseExample>

<ResponseField name="id" type="string">
  The unique identifier linked to a plan. This is used when creating a Subscription for customers.
</ResponseField>

<ResponseField name="entity" type="string">
  The entity being created. Here, it is `plan`.
</ResponseField>

<ResponseField name="interval" type="integer">
  This, combined with `period`, defines the frequency. If the billing cycle is 2 months, the value should be `2`.

  <Info>
    **Handy Tips**

    For daily plans, the minimum value should be `7`.
  </Info>
</ResponseField>

<ResponseField name="period" type="string">
  This, combined with `interval`, defines the frequency. Possible values:

  * `daily`
  * `weekly`
  * `monthly`
  * `quarterly`
  * `yearly`

  If the billing cycle is 2 months, the value should be `monthly`.
</ResponseField>

<ResponseField name="item" type="object">
  Details of the plan.
</ResponseField>

<ResponseField name="id" type="string">
  The unique identifier linked to an item. For example, `item_00000000000001`.
</ResponseField>

<ResponseField name="name" type="string">
  Name of the plan. For example, `Test Plan`.
</ResponseField>

<ResponseField name="amount" type="integer">
  Amount for the plan. When you use this plan to create a Subscription, the customer will be charged this amount periodically.
</ResponseField>

<ResponseField name="currency" type="string">
  Currency for the payment. Defaults to `USD`.
</ResponseField>

<ResponseField name="description" type="string">
  Description of the plan. For example, `Description of the test plan`.
</ResponseField>

<ResponseField name="notes" type="object">
  Notes you can enter for the contact for future reference. This is a key-value pair. You can enter a maximum of 15 key-value pairs. For example, `"note_key": "Monthly Gym"`.
</ResponseField>

<ResponseField name="created_at" type="integer">
  The Unix timestamp at which the plan was created.
</ResponseField>
