# AppUsageRecord - admin-graphql - OBJECT
Version: 2024-10

## Description
Store usage for app subscriptions with usage pricing.

### Access Scopes
The staff member must have permission to manage app billing or approve app charges if authenticated with an online access token as described in https://shopify.dev/apps/auth/oauth/access-modes.


## Fields
* [createdAt](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime! - The date and time when the usage record was created.
* [description](/docs/api/admin-graphql/2024-10/scalars/String): String! - The description of the app usage record.
* [id](/docs/api/admin-graphql/2024-10/scalars/ID): ID! - A globally-unique ID.
* [idempotencyKey](/docs/api/admin-graphql/2024-10/scalars/String): String - A unique key generated by the client to avoid duplicate charges.
* [price](/docs/api/admin-graphql/2024-10/objects/MoneyV2): MoneyV2! - The price of the usage record.
* [subscriptionLineItem](/docs/api/admin-graphql/2024-10/objects/AppSubscriptionLineItem): AppSubscriptionLineItem! - Defines the usage pricing plan the merchant is subscribed to.

## Connections



## Related queries

## Related mutations
* [appUsageRecordCreate](/docs/api/admin-graphql/2024-10/mutations/appUsageRecordCreate) Enables an app to charge a store for features or services on a per-use basis.
The usage charge value is counted towards the `cappedAmount` limit that was specified in the `appUsagePricingDetails` field when the app subscription was created.
If you create an app usage charge that causes the total usage charges in a billing interval to exceed the capped amount, then a `Total price exceeds balance remaining` error is returned.

## Related Unions

## Examples