---
title: Refund - Customer API
description: The record of refunds issued to a customer.
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/refund
  md: https://shopify.dev/docs/api/customer/latest/objects/refund.md
---

# Refund

object

The record of refunds issued to a customer.

## Fields

* created​At

  [Date​Time](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

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

  The date and time when the refund was created.

* id

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

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

  A globally-unique ID.

* return​Name

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

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

  The name of the return, if the refund was issued from a return.

* total​Refunded

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

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

  The total amount refunded across all transactions, in presentment currencies.

* updated​At

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

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

  The date and time when the refund was last updated.

***

## Map

### Fields with this object

* {}[Order.refunds](https://shopify.dev/docs/api/customer/latest/objects/Order#field-refunds)
* {}[RefundAgreement.refund](https://shopify.dev/docs/api/customer/latest/objects/RefundAgreement#field-refund)

***

## Interfaces

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

  interface

***

## ||-Refund Implements

### Implements

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