---
title: "DiscountAutomaticFreeShipping"
description: "automatic discount that offers customers free shipping."
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/objects/discount-automatic-free-shipping'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/objects/discount-automatic-free-shipping.md'
---
# DiscountAutomaticFreeShipping

automatic discount that offers customers free shipping.


- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`DiscountAutomaticFreeShipping`

## Fields

* `asyncUsageCount`

  [Int](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/int.md)

  The number of times the discount has been redeemed. This value is updated asynchronously and may not match the actual usage count.

* `combinesWith`

  [DiscountCombinesWith](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/objects/discount-combines-with.md)

  which discount classes the discount can combine with.
  

* `createdAt`

  [Date](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/date.md)

  The time when the discount was created.

* `destinationSelection`

  [DiscountShippingDestinationSelection](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/unions/discount-shipping-destination-selection.md)

  Shipping destinations eligible for the discount.

* `discountClass`

  [MerchandiseDiscountClass](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/enums/merchandise-discount-class.md)

  The class of the discount for combining purposes.

* `endsAt`

  [Date](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/date.md)

  The time when the discount ends. For open-ended discounts, use null.
  
  

* `maximumShippingPrice`

  [MoneyV2](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/objects/money-v2.md)

  Maximum shipping cost eligible for the discount.
  

* `minimumRequirement`

  [DiscountMinimumRequirement](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/unions/discount-minimum-requirement.md)

  Minimum subtotal or quantity required to apply the discount.

* `shortSummary`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  discount short summary.
  
  

* `startsAt`

  [Date](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/date.md)

  The time when the discount starts.

* `status`

  [DiscountStatus](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/enums/discount-status.md)

  discount status.
  
  

* `summary`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  discount summary.

* `title`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  discount title.

* `totalSales`

  [MoneyV2](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/objects/money-v2.md)

  Total sales of orders using the discount.

* `updatedAt`

  [Date](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/date.md)

  The time when the discount was updated.

## Schema Definition

```graphql
type DiscountAutomaticFreeShipping { 
	asyncUsageCount: Int
	combinesWith: DiscountCombinesWith
	createdAt: Date
	destinationSelection: DiscountShippingDestinationSelection
	discountClass: MerchandiseDiscountClass
	endsAt: Date
	maximumShippingPrice: MoneyV2
	minimumRequirement: DiscountMinimumRequirement
	shortSummary: String
	startsAt: Date
	status: DiscountStatus
	summary: String
	title: String
	totalSales: MoneyV2
	updatedAt: Date 
}
```

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes).