---
title: "List all refunds"
method: GET
path: "/refunds/"
tags: ["Refunds"]
---

# List all refunds

`GET /refunds/`

Returns a list all refund objects.

## Headers

- `SHIPPO-API-VERSION` string

## Response `200`

Paginated list of refunds

- RefundPaginatedList
  - `next` string
  - `previous` string
  - `results` Refund[]
    - `object_created` string, date-time — Date and time of object creation.
    - `object_id` string — Unique identifier of the given object.
    - `object_owner` string — Username of the user who created the object.
    - `object_updated` string, date-time — Date and time of last object update.
    - `status` 'QUEUED' | 'PENDING' | 'SUCCESS' | 'ERROR' — Indicates the status of the Refund.
    - `test` boolean — Indicates whether the object has been created in test mode.
    - `transaction` string — Object ID of the Transaction to be refunded.

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/goshippo/apis/shippo-address-api.md) · [All operations](https://skmtc.net/goshippo/apis/shippo-address-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goshippo/shippo-address-api/revisions/26fcc6af452a/schema)