> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Guided Usage data source

> Know how the Guided Usage data source is used

Know how the Guided Usage data source is used

## Data source

After you enable Prepaid with Drawdown and Unbilled Usage, charge-level guided usage objects will be automatically generated upon usage upload. The guided usage object is used in the following ways:

* Prepaid with Drawdown subscriptions will be drawn down based on guided usage.
* Unbilled usage will be calculated based on guided usage.

​ Navigation: **Reporting > Data Sources** and select **Guided Usage** as the data source.

## Objects available in the data source

The following sections provide the lists of objects available in the data source.

## Base object description

<table>
  <tr>
    <th>
      Zuora object
    </th>

    <th>
      Description
    </th>
  </tr>

  <tr>
    <td>
      Guided Usage
    </td>

    <td>
      The guided usage object. It includes the following fields:

      * Created By ID
      * Created Date
      * Drawdown Remaining Quantity
      * Drawdown Request ID
      * ID
      * Import ID
      * Invoice Owner ID
      * Quantity
      * Status
      * Unit Of Measure
      * Updated By ID
      * Updated Date
      * Usage File ID
      * Usage Start Date
    </td>
  </tr>
</table>

## Related objects

<table>
  <tr>
    <th>
      Object
    </th>

    <th>
      Description
    </th>
  </tr>

  <tr>
    <td>
      Account
    </td>

    <td>
      The customer account that generates the guided usage.
    </td>
  </tr>

  <tr>
    <td>
      Bill To
    </td>

    <td>
      The Bill-To contact of the account.
    </td>
  </tr>

  <tr>
    <td>
      Default Payment Method
    </td>

    <td>
      The default payment method used to make payments for the guided usage.
    </td>
  </tr>

  <tr>
    <td>
      Entity
    </td>

    <td>
      The entity that the data relates to.

      Part of the [Multi-entity](/docs/platform/user-management/multi-entity/overview-of-multi-entity) feature.
    </td>
  </tr>

  <tr>
    <td>
      Parent Account
    </td>

    <td>
      The parent account that owns the guided usage.
    </td>
  </tr>

  <tr>
    <td>
      Product
    </td>

    <td>
      The product associated with the guided usage.
    </td>
  </tr>

  <tr>
    <td>
      Product Rate Plan
    </td>

    <td>
      The product rate plan associated with the guided usage.
    </td>
  </tr>

  <tr>
    <td>
      Product Rate Plan Charge
    </td>

    <td>
      The product rate plan charge associated with the guided usage.
    </td>
  </tr>

  <tr>
    <td>
      Rate Plan
    </td>

    <td>
      The rate plan associated with the guided usage.
    </td>
  </tr>

  <tr>
    <td>
      Rate Plan Charge
    </td>

    <td>
      The rate plan charge associated with the guided usage.
    </td>
  </tr>

  <tr>
    <td>
      Sold To
    </td>

    <td>
      The Sold-To contact of the account.
    </td>
  </tr>

  <tr>
    <td>
      Subscription
    </td>

    <td>
      The subscription the guided usage is generated from.
    </td>
  </tr>

  <tr>
    <td>
      Usage
    </td>

    <td>
      The usage entry associated with the guided usage.
    </td>
  </tr>
</table>