> ## 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":"INR",
          "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":"INR",
          "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>

<Info>
  **Handy Tips**

  We allow custom frequencies while creating a plan (for example, once in 3 weeks).

  * For UPI, all undefined frequencies except `daily`, `weekly`, `monthly`, `quarterly` and `yearly` are considered `as-presented`.
  * For domestic cards, all undefined frequencies except `weekly`, `monthly` and `yearly` are considered `as-presented` while registering the mandate with banks.
</Info>

<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>

In the case of three decimal currencies, such as KWD, BHD and OMR, to refund a payment of `295.991`, pass the value as `295990`. And in the case of zero decimal currencies such as JPY, to refund a payment of 295, pass the value as `295`.

<Warning>
  **Watch Out!**

  As per payment guidelines, you should pass the last decimal number as 0 for three decimal currency payments. For example, if you want to refund a customer 99.991 KD for a transaction, you should pass the value for the amount parameter as `99990` and not `99991`.
</Warning>

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

You can accept payment in any of the  [supported currencies](/docs/payments/international-payments#supported-currencies).

<Info>
  **Handy Tips**

  Razorpay has added support for zero decimal currencies, such as JPY, and three decimal currencies, such as KWD, BHD, and OMR, allowing businesses to accept international payments in these currencies. Know more about [Currency Conversion](/docs/payments/international-payments/currency-conversion) (May 2024).
</Info>

<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>