# Get refunds

> GET `/secure/refunds/getrefunds`
> Part of the Payments API reference. Source: https://hub.ozow.com/api-reference/payments-api/get-secure-refunds-getrefunds/

Server: `https://api.ozow.com` (Production)

Other environments: `https://stagingapi.ozow.com` (Staging)

List refunds by date and status.

## Authentication

- `BearerToken` (HTTP bearer)
  - The token generated by the `Get API token` operation. The same token is used for every request until it expires.

## Query parameters

- `refundDate` (string, required) - The date of the refunds you would like to be returned.
- `status` (string, required) - The status of the refunds you would like to be returned.

## Responses

### 200 OK

**application/json**

array of Refund

**application/xml**

array of Refund

### 400 Bad Request. The operation could not be carried out. The body is a message rather than a structured error.

string

Example (example 1):

```json
There was an error processing your request
```

### 401 Unauthorized. The `ApiKey` header is missing or does not match the site, or for a `Secure` operation the bearer token is missing, expired or invalid.

string

Example (example 1):

```json
API key is missing or invalid.
```