---
schema_version: "1"
id: 719d772e081327438e6d7d29dbfe6fc312d0991d21992bc60c8e0920b9aa779a
title: Revenue | Get Usage Details
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_ref_rev_usage_get_usage_details.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_ref_rev_usage_get_usage_details.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 9333ab0b4e38b0fef21fc9546ef47649e974cba69902bd36b4461ca0458f3d69
description: Gets the details of the consumption overages for up to five usage resources associated with an account by using the account ID.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Revenue | Get Usage Details

Gets the details of the consumption overages for up to five usage resources associated with an account by using the account ID.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions of Revenue Cloud Advanced and Revenue Cloud Billing with the Agentforce Employee Agent add-on. It also requires the Flex Credits Metering add-on and the Usage Management add-on.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
      <colgroup>
        <col style="width:50%">
        <col style="width:50%">
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="col" class="slds-cell-wrap" style="text-align:center;vertical-align:top;" id="d15678e67">User Permissions Needed</th>
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d15678e70">&nbsp;</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d15678e67 d15678e70 ">See <a href="https://help.salesforce.com/s/articleView?id=ai.agent_actions_common_perms.htm&amp;type=5&amp;language=en_US" target="_blank">Common User Access for Standard Agent Actions</a>.</td>

        </tr>
      </tbody>
    </table>

## Action Details

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><colgroup><col style="width:50%"> <col style="width:50%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">API Name</td><td class="slds-cell-wrap" style="vertical-align:top;">GetUsageDetails</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Reference Action Type</td><td class="slds-cell-wrap" style="vertical-align:top;">Prompt</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Reference Action</td><td class="slds-cell-wrap" style="vertical-align:top;">Get Usage Details</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Does this action execute one or more prompt templates?</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Required Setup</td><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=ind.qocal_agentforce_quote_mgmt.htm&amp;language=en_US" target="_blank">Quote Management with Agentforce</a></td></tr></tbody></table>

## Guidelines and Considerations

- You can only request up to five accounts in an agent request.
- The agent supports only anchor products with usage resources of type usage.
- The agent provides the overage details in the equivalent amount that is to be billed for the current billing cycle.
- The agent can create a quote with only Pack usage type products.
- When you use the agent to check for overages, and then ask the agent to create a quote for the over-consumed usage resource, you must add the term usage resource in the request. For example, if the account has over-consumed 50-GB data storage, then you must say, create a quote for the account Acme with the data storage usage resource.
- The overage details that the agent returns are before liable summary generation. After the liable summaries are generated for a period, overage details won’t be returned.

## Get Usage Details and Prompt Template

The Get Account Usage Details agent action uses Get Account Usage Details prompt template to retrieve consumption details of the usage resources associated with accounts.

The action passes the required input parameter account IDs. The parameter includes the list of comma-delimited account IDs whose usage details are to be fetched.