---
title: ApplicationCredit
description: Request to create an application credit for a particular shop.
api_version: 2025-10
api_name: admin-rest
api_type: rest
source_url:
  html: https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcredit
  md: https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcredit.md
---

![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).

# Application​Credit

Important

Creating application credits through this resource is being deprecated. App credits can continue to be created using the [appCreditCreate mutation](https://shopify.dev/docs/api/partner/unstable/mutations/appCreditCreate) in the Partner API.

The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.

The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.

Note

The ApplicationCredit resource can be used only by apps that use Shopify's Billing API ([ApplicationCharge](https://shopify.dev/docs/admin-api/rest/reference/billing/applicationcharge), [RecurringApplicationCharge](https://shopify.dev/docs/admin-api/rest/reference/billing/recurringapplicationcharge), or [UsageCharge](https://shopify.dev/docs/admin-api/rest/reference/billing/usagecharge)).

\#

## Endpoints

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcredit#get-application-credits)

  [/admin/api/latest/application\_​credits.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcredit#get-application-credits)

  Retrieves all application credits

  [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/queries/appInstallation?example=retrieves-all-application-credits)

  [appInstallation](https://shopify.dev/docs/api/admin-graphql/latest/queries/appInstallation?example=retrieves-all-application-credits)

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcredit#get-application-credits-application-credit-id)

  [/admin/api/latest/application\_​credits/{application\_​credit\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcredit#get-application-credits-application-credit-id)

  Retrieves a single application credit

***

## The ApplicationCredit resource

### Properties

***

description

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.description)

[description](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.description)

The description of the application credit.

***

id

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.id)

[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.id)

The ID of the application credit.

***

amount

string

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.amount)

[amount](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.amount)

The amount refunded by the application credit.

***

test

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.test)

[test](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.test)

Whether the application credit is a test transaction. Valid values: `true`,`null`

***

currency

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.amount)

[amount](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCredit#field-AppCredit.fields.amount)

The currency of the application credit amount.

***

{}

## The ApplicationCredit resource

```json
{
  "description": "Super Mega Plan 1000 emails",
  "id": 675931192,
  "amount": "10",
  "test": null,
  "currency": "USD"
}
```

***

## getRetrieves all application credits

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/queries/appInstallation?example=retrieves-all-application-credits)

[appInstallation](https://shopify.dev/docs/api/admin-graphql/latest/queries/appInstallation?example=retrieves-all-application-credits)

Retrieves all application credits

### Parameters

***

api\_version

string

required

***

fields

A comma-separated list of fields to include in the response.

***

### Examples

Retrieve all application credits

get

## /admin/api/2025-10/application\_​credits.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/application_credits.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "application_credits": [
    {
      "id": 140583599,
      "amount": "5.00",
      "description": "credit for application refund",
      "test": null,
      "currency": "USD"
    }
  ]
}
```

### examples

* #### Retrieve all application credits

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/application_credits.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.ApplicationCredit.all({
    session: session,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::ApplicationCredit.all(
    session: test_session,
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.ApplicationCredit.all({
    session: session,
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"application_credits":[{"id":140583599,"amount":"5.00","description":"credit for application refund","test":null,"currency":"USD"}]}
  ```

***

## getRetrieves a single application credit

Retrieves a single application credit

### Parameters

***

api\_version

string

required

***

application\_credit\_id

string

required

***

fields

A comma-separated list of fields to include in the response.

***

### Examples

Retrieve a single application credit

Path parameters

application\_​credit\_​id=​140583599

string

required

get

## /admin/api/2025-10/application\_​credits/140583599.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/application_credits/140583599.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "application_credit": {
    "id": 140583599,
    "amount": "5.00",
    "description": "credit for application refund",
    "test": null,
    "currency": "USD"
  }
}
```

### examples

* #### Retrieve a single application credit

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/application_credits/140583599.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.ApplicationCredit.find({
    session: session,
    id: 140583599,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::ApplicationCredit.find(
    session: test_session,
    id: 140583599,
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.ApplicationCredit.find({
    session: session,
    id: 140583599,
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"application_credit":{"id":140583599,"amount":"5.00","description":"credit for application refund","test":null,"currency":"USD"}}
  ```