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

# Usage data source

> A data source to export usage data that is used to determine usage-based charges.

A data source to export usage data that is used to determine usage-based charges.

## Overview

Use this data source to export usage data that is used to determine usage-based charges. Usage data can be tied to associated [Accounts](/docs/platform/integration/apis/soap-api/soap-api-object-reference/account), [Subscriptions](/docs/platform/integration/apis/soap-api/soap-api-object-reference/subscription) and Charges, and [Product Catalog](/docs/platform/integration/apis/soap-api/soap-api-object-reference/product) data.

## Base object

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

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

  <tr>
    <td>
      [Usage](/docs/platform/integration/apis/soap-api/soap-api-object-reference/usage)
    </td>

    <td>
      Fields on a usage. It includes the following fields. See the field description in the [Usage](/docs/platform/integration/apis/soap-api/soap-api-object-reference/usage) object reference.

      * Account Number
      * Created By ID
      * Created Date
      * Description
      * End Date
      * ID
      * Import ID
      * Quantity
      * RBS Status
      * Source Type
      * Start Date
      * Submission Date
      * Unit of Measure
      * Updated By ID
      * Updated Date

      The following field is only available if you have the Prepaid with Drawdown feature enabled.

      * Unique Key
    </td>
  </tr>
</table>

## Related objects

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

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

  <tr>
    <td>
      Account
    </td>

    <td>
      The Customer Account and corresponding details to which the usage belongs.
    </td>
  </tr>

  <tr>
    <td>
      Amendment
    </td>

    <td>
      The amendment that is tied to the usage, if applicable.
    </td>
  </tr>

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

    <td>
      The contact of the entity or person who you bill for your product or service.
    </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. Contains the following fields:

      * Address 1
      * Address 2
      * City
      * Country
      * Created By ID
      * Created Date
      * Display Name
      * Email
      * ID
      * Name
      * Postal Code
      * State
      * Updated By ID
      * Updated Date
    </td>
  </tr>

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

    <td>
      The contact of the entity/person to whom you sold your product or service.
    </td>
  </tr>

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

    <td>
      Details and data of the default payment method of the customer account.
    </td>
  </tr>

  <tr>
    <td>
      Product
    </td>

    <td>
      The product related to the Usage.
    </td>
  </tr>

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

    <td>
      The pricing plan (in the Product Catalog) related to the Usage.
    </td>
  </tr>

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

    <td>
      The charge (in the Product Catalog) that is related to the Usage.
    </td>
  </tr>

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

    <td>
      The pricing plan (for the subscription) that is related to the Usage.
    </td>
  </tr>

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

    <td>
      The charge (for the subscription) that is related to the Usage.
    </td>
  </tr>

  <tr>
    <td>
      Subscription
    </td>

    <td>
      The subscription the usage belongs to.
    </td>
  </tr>

  <tr>
    <td>
      Usage
    </td>

    <td>
      This is the base object, which has information around the Usage record.
    </td>
  </tr>
</table>