# Get Settlements

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

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

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

Retrieve the lastest settlements created for the merchant.

## 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

- `count` (integer) - The number of settlements to return. The max allowed value is 100.

## Responses

### 200 Success

**application/json**

- `settlements` (array of Settlement, required) - The latest settlements for the merchant.
- `errors` (array of string, required) - Any errors that occurred for the request.

**application/xml**

`SettlementList`, the same schema listed in full earlier in this document. Its own page: https://hub.ozow.com/api-reference/payments-api/schemas/settlement-list.md

### 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.
```