---
title: SaleConnection - Customer API
description: An auto-generated type for paginating through multiple Sales.
api_version: 2025-10
api_name: customer
type: connection
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/connections/saleconnection
  md: https://shopify.dev/docs/api/customer/latest/connections/saleconnection.md
---

# Sale​Connection

connection

An auto-generated type for paginating through multiple Sales.

## Fields with this connection

* [Order​Agreement.​sales](https://shopify.dev/docs/api/customer/latest/objects/OrderAgreement#field-sales)

  OBJECT

  An agreement associated with an order placement.

* [Order​Edit​Agreement.​sales](https://shopify.dev/docs/api/customer/latest/objects/OrderEditAgreement#field-sales)

  OBJECT

  An agreement related to an edit of the order.

* [Refund​Agreement.​sales](https://shopify.dev/docs/api/customer/latest/objects/RefundAgreement#field-sales)

  OBJECT

  An agreement for refunding all or a portion of the order between the merchant and the customer.

* [Return​Agreement.​sales](https://shopify.dev/docs/api/customer/latest/objects/ReturnAgreement#field-sales)

  OBJECT

  An agreement between the merchant and customer for a return.

* [Sales​Agreement.​sales](https://shopify.dev/docs/api/customer/latest/interfaces/SalesAgreement#field-sales)

  INTERFACE

  A contract between a merchant and a customer to do business. Shopify creates a sales agreement whenever an order is placed, edited, or refunded. A sales agreement has one or more sales records, which provide itemized details about the initial agreement or subsequent changes made to the order. For example, when a customer places an order, Shopify creates the order, generates a sales agreement, and records a sale for each line item purchased in the order. A sale record is specific to a type of order line. Order lines can represent different things such as a purchased product, a tip added by a customer, shipping costs collected at checkout, and more.

***

## Possible returns

* edges

  [\[Sale​Edge!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleEdge)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.

* nodes

  [\[Sale!\]!](https://shopify.dev/docs/api/customer/latest/interfaces/Sale)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A list of nodes that are contained in SaleEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/customer/latest/objects/PageInfo)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page.

***

## Map

### Fields with this connection

* {}[Order​Agreement.sales](https://shopify.dev/docs/api/customer/latest/objects/OrderAgreement#field-sales)
* {}[Order​Edit​Agreement.sales](https://shopify.dev/docs/api/customer/latest/objects/OrderEditAgreement#field-sales)
* {}[Refund​Agreement.sales](https://shopify.dev/docs/api/customer/latest/objects/RefundAgreement#field-sales)
* {}[Return​Agreement.sales](https://shopify.dev/docs/api/customer/latest/objects/ReturnAgreement#field-sales)
* ||-[Sales​Agreement.sales](https://shopify.dev/docs/api/customer/latest/interfaces/SalesAgreement#field-sales)

### Possible returns

* <->[Sale​Connection.edges](https://shopify.dev/docs/api/customer/latest/objects/SaleConnection#field-edges)
* <->[Sale​Connection.nodes](https://shopify.dev/docs/api/customer/latest/interfaces/SaleConnection#field-nodes)
* <->[Sale​Connection.pageInfo](https://shopify.dev/docs/api/customer/latest/objects/SaleConnection#field-pageInfo)