---
title: AppUsageRecord - GraphQL Admin
description: Store usage for app subscriptions with usage pricing.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/appusagerecord
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/appusagerecord.md
---

# App​Usage​Record

object

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

Store usage for app subscriptions with usage pricing.

## Fields

* created​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the usage record was created.

* description

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  The description of the app usage record.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID.

* idempotency​Key

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  A unique key generated by the client to avoid duplicate charges.

* price

  [Money​V2!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2)

  non-null

  The price of the usage record.

* subscription​Line​Item

  [App​Subscription​Line​Item!](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscriptionLineItem)

  non-null

  Defines the usage pricing plan the merchant is subscribed to.

***

## Map

### Fields and connections with this object

* {}[AppSubscriptionLineItem.usageRecords](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscriptionLineItem#field-AppSubscriptionLineItem.fields.usageRecords)
* <->[AppUsageRecordConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/AppUsageRecordConnection#returns-nodes)
* {}[AppUsageRecordEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppUsageRecordEdge#field-AppUsageRecordEdge.fields.node)

***

## Mutations

* [app​Usage​Record​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appUsageRecordCreate)

  mutation

  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.

***

## <\~> AppUsageRecord Mutations

### Mutated by

* <\~>[app​Usage​Record​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appUsageRecordCreate)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## ||-AppUsageRecord Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)