---
title: "DiscountCodeFreeShipping"
description: "A code discount that offers customers free shipping on their order."
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-code-free-shipping'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/objects/discount-code-free-shipping.md'
---
# DiscountCodeFreeShipping

A code discount that offers customers free shipping on their order.



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

## Type Signature

`DiscountCodeFreeShipping`

## Fields

* `appliesTimesPerCustomer`

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

  The limit on the number of times each customer can use the discount, null means no limit

* `asyncUsageCount`

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

  The number of times that the discount has been used.
  
  

* `codeCount`

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

  The number of redeem codes for the discount.
  
  

* `codes`

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

  Discount codes

* `combinesWith`

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

  Determines which discount classes the discount can combine with.
  
  

* `createdAt`

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

  The date and time when the discount was created.

* `customerSelection`

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

  The customers that can use the discount.
  
  

* `destinationSelection`

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

  A shipping destination that qualifies 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 date and 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)

  The maximum shipping price amount accepted to qualify for the discount.
  
  

* `minimumRequirement`

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

  The minimum subtotal or quantity that's required for the discount to be applied.
  
  

* `shareableUrls`

  [[DiscountShareableUrl]](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/objects/discount-shareable-url.md)

  URLs that can be used to share the discount.

* `shortSummary`

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

  A short summary of the discount.

* `startsAt`

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

  The date and time when the discount starts.

* `status`

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

  The status of the discount.
  
  

* `summary`

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

  A detailed summary of the discount.
  
  

* `title`

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

  The title of the discount.
  
  

* `totalSales`

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

  The total sales from orders where the discount was used.

* `updatedAt`

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

  The date and time when the discount was updated.
  
  

* `usageLimit`

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

  The maximum number of times that the discount can be used.
  
  

## Schema Definition

```graphql
type DiscountCodeFreeShipping { 
	appliesTimesPerCustomer: Int
	asyncUsageCount: Int
	codeCount: Int
	codes: [String]
	combinesWith: DiscountCombinesWith
	createdAt: Date
	customerSelection: DiscountCustomerSelection
	destinationSelection: DiscountShippingDestinationSelection
	discountClass: MerchandiseDiscountClass
	endsAt: Date
	maximumShippingPrice: MoneyV2
	minimumRequirement: DiscountMinimumRequirement
	shareableUrls: [DiscountShareableUrl]
	shortSummary: String
	startsAt: Date
	status: DiscountStatus
	summary: String
	title: String
	totalSales: MoneyV2
	updatedAt: Date
	usageLimit: Int 
}
```

## 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).