• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

You are viewing an old version of the API
V1 list refunds
V1
Connect V1 APIs and webhooks

Use the Square API for all new development. See When to use Connect V1 to learn more about working with V1 endpoints.

Deprecated
Effective May 13th, 2021

Provides the details for all refunds initiated by a merchant or any of the merchant's mobile staff during a date range.

Date ranges cannot exceed one year in length.

Permissions
PAYMENTS_READ

Deprecation date
2021-05-13
Retirement date
TBD
Replaced by
ListPaymentRefunds
Migration guide
Name Description
location_id
string

Required

The ID of the location to list refunds for.

Name Description
order
string

The order in which payments are listed in the response.

begin_time
string

The beginning of the requested reporting period, in ISO 8601 format. If this value is before January 1, 2013 (2013-01-01T00:00:00Z), this endpoint returns an error. Default value: The current time minus one year.

end_time
string

The end of the requested reporting period, in ISO 8601 format. If this value is more than one year greater than begin_time, this endpoint returns an error. Default value: The current time.

limit
integer (32-bit)

The approximate number of refunds to return in a single response. Default: 100. Max: 200. Response may contain more results than the prescribed limit when refunds are made simultaneously to multiple tenders in a payment or when refunds are generated in an exchange to account for the value of returned goods.

batch_token
string

A pagination cursor to retrieve the next set of results for your original query to the endpoint.

Response Fields

Name Description
{items}
Refund [ ]

Examples

You are viewing an old version of the API
GET /v1/{location_id}/refunds
cURL
  • cURL
curl https://connect.squareup.com/v1/location_id0/refunds \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'