> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List refunds

> Returns a list of all refunds in your Plane workspace.

### Parameters

<ParamField query="status" type="string">
  Only return refunds in the given status.
</ParamField>

<ParamField query="limit" type="number">
  A limit on the number of objects to be returned. Limit can range between 1 and 100, and the
  default is 10.
</ParamField>

<ParamField query="starting_after" type="string">
  A cursor for use in pagination. `starting_after` is an object ID that defines your place in the
  list.
</ParamField>

<ParamField query="ending_before" type="string">
  A cursor for use in pagination. `ending_before` is an object ID that defines your place in the
  list.
</ParamField>

### Returns

A dictionary with a `refunds` property that contains an array of
[Refund](/reference/refunds/object) objects.

<ResponseExample>
  ```json Response theme={null}
  {
    "refunds": [
      {
        "id": "re_1PqJvEf9iWm3mK7P2fZp9Qxc",
        "date": "2025-08-15",
        "amount": "1000.00",
        "currency": "USD",
        "reference": "RF-2025-0815",
        "note": "Cancelled contractor payment",
        "status": "succeeded",
        "source": "src_4a8S6Cm7qN9xL2eP",
        "entity": "ent_7Vu2fTc0bL3kQ9mR"
      }
    ]
  }
  ```
</ResponseExample>