# Refunds

Refund objects represent your customer's refunded transactions. You can use them in conjunction with Payments to reconcile transactions and handle specific logic.

### Get all refunds

This method retrieves a list of all refunded transactions.

## GET /v1/transaction/refund/

>

```json
{"openapi":"3.0.3","info":{"title":"Secured Checkout API","version":"1.0.0"},"security":[{"tokenAuth":[]},{"jwtAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Token-based authentication with required prefix \"Token\""},"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PaginatedRefundList":{"type":"object","required":["count","results"],"properties":{"count":{"type":"integer"},"next":{"type":"string","nullable":true,"format":"uri"},"previous":{"type":"string","nullable":true,"format":"uri"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Refund"}}}},"Refund":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,6}(?:\\.\\d{0,2})?$"},"currency":{"type":"string","readOnly":true},"payment":{"type":"string","format":"uuid"},"gateway_id":{"type":"string","maxLength":255},"created":{"type":"string","format":"date-time","readOnly":true}},"required":["amount","created","currency","gateway_id","id","payment"]}}},"paths":{"/v1/transaction/refund/":{"get":{"operationId":"transaction_refund_list","parameters":[{"name":"page","required":false,"in":"query","description":"A page number within the paginated result set.","schema":{"type":"integer"}}],"tags":["transaction"],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedRefundList"}}},"description":""}}}}}}
```

### Get refund

This method fetches detailed information about a specific refunded transaction using its unique identifier, allowing you to retrieve the amount, and other relevant details for that refund.

## GET /v1/transaction/refund/{id}/

>

```json
{"openapi":"3.0.3","info":{"title":"Secured Checkout API","version":"1.0.0"},"security":[{"tokenAuth":[]},{"jwtAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Token-based authentication with required prefix \"Token\""},"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Refund":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,6}(?:\\.\\d{0,2})?$"},"currency":{"type":"string","readOnly":true},"payment":{"type":"string","format":"uuid"},"gateway_id":{"type":"string","maxLength":255},"created":{"type":"string","format":"date-time","readOnly":true}},"required":["amount","created","currency","gateway_id","id","payment"]}}},"paths":{"/v1/transaction/refund/{id}/":{"get":{"operationId":"transaction_refund_retrieve","parameters":[{"in":"path","name":"id","schema":{"type":"string"},"required":true}],"tags":["transaction"],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Refund"}}},"description":""}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://paytree.gitbook.io/api/refunds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.