> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/developers/api-reference/reference/objects/refund.md).

# The refund object

The refund object in the Shortcut API - every field, an example, and the endpoints that return it.

Money returned to a customer for a payment.

## Fields

| Field        | Type              | Description                                                            |
| ------------ | ----------------- | ---------------------------------------------------------------------- |
| `id`         | id                | The refund's id.                                                       |
| `object`     | `"refund"`        | Always `refund`.                                                       |
| `invoiceId`  | id                | The invoice the payment was on.                                        |
| `paymentId`  | id                | The payment refunded.                                                  |
| `amount`     | number            | The refund, in US dollars.                                             |
| `status`     | string            | `succeeded`, `pending`, or `failed`, as the card processor reports it. |
| `refundedAt` | timestamp or null | When it went through.                                                  |

## Example

```json
{
  "id": "d125335f-cd6f-4ea6-89b9-a9edc603e534",
  "object": "refund",
  "invoiceId": "0aca2afe-0714-4645-835e-a18cffa8dcd3",
  "paymentId": "60d0aaf1-5d1a-4638-8965-217f55af5cc6",
  "amount": 129.5,
  "status": "Example status",
  "refundedAt": null
}
```

## Endpoints

| Endpoint                         | What it does     |
| -------------------------------- | ---------------- |
| `POST /v1/invoices/{id}/refunds` | Refund a payment |
