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

> Use this reference to view all the fields associated with the usage data dictionary.

Use this reference to view all the fields associated with the usage data dictionary.

Usage is the amount of resources a customer uses. You can track the usage of metered resources, then charge based on the amount that your customers consume.

> **Note**
>
> Fields with an asterisk mark indicate mandatory fields.

<table>
  <tr>
    <th>
      Name
    </th>

    <th>
      Description
    </th>

    <th>
      Value
    </th>
  </tr>

  <tr>
    <td>
      Account Id
    </td>

    <td>
      The ID of the account associated with the usage data.
    </td>

    <td>
      Alphanumeric
    </td>
  </tr>

  <tr>
    <td>
      Account Number\*
    </td>

    <td>
      The number of the account associated with the usage data.
    </td>

    <td>
      Alphanumeric
    </td>
  </tr>

  <tr>
    <td>
      Charge Id
    </td>

    <td>
      The OrginalId of the rate plan charge related to the usage record.
    </td>

    <td>
      Alphanumeric
    </td>
  </tr>

  <tr>
    <td>
      Charge Number
    </td>

    <td>
      A unique number for the rate plan charge related to the usage record
    </td>

    <td>
      Alphanumeric
    </td>
  </tr>

  <tr>
    <td>
      Description
    </td>

    <td>
      A description of the usage data.
    </td>

    <td>
      Alphanumeric
    </td>
  </tr>

  <tr>
    <td>
      End Date Time
    </td>

    <td>
      The end date and time of a range of time when usage is tracked. Use this field for reporting; this field doesn't affect usage calculation.
    </td>

    <td>
      Date(YYYY-MM-DDTHH:MM:SS (or) YYYY-MM-DDTHH:MM:SS\[+-]HH:MM)
    </td>
  </tr>

  <tr>
    <td>
      Quantity\*
    </td>

    <td>
      Indicates the number of units used.
    </td>

    <td>
      Decimal\{22,9}
    </td>
  </tr>

  <tr>
    <td>
      Start Date Time\*
    </td>

    <td>
      The start date and time of a range of time when usage is tracked. Zuora uses this field value to determine the usage date. Unlike the `EndDateTime`, the `StartDateTime` field does affect usage calculation.
    </td>

    <td>
      Date(YYYY-MM-DDTHH:MM:SS (or) YYYY-MM-DDTHH:MM:SS\[+-]HH:MM)
    </td>
  </tr>

  <tr>
    <td>
      Subscription Id
    </td>

    <td>
      The OriginalId of the subscription that contains the fees related to the usage data.
    </td>

    <td>
      Alphanumeric
    </td>
  </tr>

  <tr>
    <td>
      Subscription Number
    </td>

    <td>
      The name\* of the subscription that contains the fees related to the usage data.
    </td>

    <td>
      Alphanumeric
    </td>
  </tr>

  <tr>
    <td>
      Unique Key
    </td>

    <td>
      The unique external reference of the usage record. This field is available only when:

      * The `X-Zuora-WSDL-Version` request header is set to 114 or later.
      * The [Prepaid with Drawdown](https://docs.zuora.com/?resourceId=billing-prepaid-with-drawdown-overview) feature or the [Unbilled Usage](https://docs.zuora.com/?resourceId=billing-unbilled-usage) feature is enabled.

      For more information, see [Upload usage record with unique key](https://docs.zuora.com/?resourceId=billing-unbilled-usage).
    </td>

    <td>
      string
    </td>
  </tr>

  <tr>
    <td>
      Units of measure\*
    </td>

    <td>
      Specifies the units to measure usage. Units of measure are configured in the web-based UI. Your values depend on your configuration in `Z-Billing > Settings.`
    </td>

    <td>
      Alphanumeric
    </td>
  </tr>
</table>