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

# List recurring bill items

### Request

This request supports pagination.

<ParamField query="leaseId" type="string">
  The lease for which recurring bill items will be returned
</ParamField>

### Response

<ResponseField name="recurringBillItems" type="array">
  <Expandable>
    <ResponseField name="id" type="string">
      The unique identifier for the recurring bill item
    </ResponseField>

    <ResponseField name="ownerId" type="string">
      The identifier for the owner associated with the recurring bill item
    </ResponseField>

    <ResponseField name="leaseId" type="string">
      The identifier for the lease associated with the recurring bill item
    </ResponseField>

    <ResponseField name="created" type="date">
      The creation date and time of the recurring bill item in ISO 8601 format
    </ResponseField>

    <ResponseField name="modified" type="date">
      The last modification date and time of the recurring bill item in ISO 8601 format
    </ResponseField>

    <ResponseField name="productKey" type="string">
      The key or identifier for the product or service billed (e.g., "key:rent")
    </ResponseField>

    <ResponseField name="startedOn" type="date">
      First due date for the recurring bill item in ISO 8601 format
    </ResponseField>

    <ResponseField name="cancelledOn" type="date">
      The date in ISO 8601 format on which recurring bill item is stopped from being billed
    </ResponseField>

    <ResponseField name="endedOn" type="date">
      The date in ISO 8601 format on which recurring bill item ends billing
    </ResponseField>

    <ResponseField name="billingCycle" type="object">
      <Expandable>
        <ResponseField name="timeUnit" type="string">
          Time unit based on which the billing cycle is calculated ("Month")
        </ResponseField>

        <ResponseField name="periodLength" type="integer">
          The number of time units in the billing cycle (e.g., 1 month, 3 months)
        </ResponseField>

        <ResponseField name="start" type="integer">
          Index of a month when the billing cycle starts (e.g., 1 for January)
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="amountRecords" type="array">
      <Expandable>
        <ResponseField name="id" type="string">
          The unique identifier for the amount record
        </ResponseField>

        <ResponseField name="value" type="object">
          The amount charged for the recurring bill item

          <Expandable>
            <ResponseField name="currency" type="string">
              The currency code for the recurring bill item amount (e.g., "DKK")
            </ResponseField>

            <ResponseField name="amount" type="number">
              The amount of the recurring bill item amount (e.g., 100.00)
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="start" type="date">
          The date in ISO 8601 format from which the amount is valid
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="vatRecords" type="array">
      <Expandable>
        <ResponseField name="id" type="string">
          The unique identifier for the VAT Record
        </ResponseField>

        <ResponseField name="value" type="object">
          The VAT details for the recurring bill item

          <Expandable>
            <ResponseField name="taxMode" type="string">
              The tax mode for the VAT (e.g., "Exempt", "Exclusive")
            </ResponseField>

            <ResponseField name="taxRate" type="number">
              The tax rate for the VAT (e.g., 0.25)
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="start" type="date">
          The date in ISO 8601 format from which the VAT is valid
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="descriptionRecords" type="array">
      <Expandable>
        <ResponseField name="id" type="string">
          The unique identifier for the description record
        </ResponseField>

        <ResponseField name="value" type="string">
          The content of the description that is going to be put on the bill
        </ResponseField>

        <ResponseField name="start" type="date">
          The date in ISO 8601 format from which the description is valid
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="quantityRecords" type="array">
      <Expandable>
        <ResponseField name="id" type="string">
          The unique identifier for the quantity record
        </ResponseField>

        <ResponseField name="value" type="Number">
          The quantity of items that is going to be put on the bill
        </ResponseField>

        <ResponseField name="start" type="date">
          The date in ISO 8601 format from which the quantity is valid
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>