# Get Banking Details

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

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

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

The Ozow account to deposit into for a reference created earlier, and the reference the deposit must carry.

## Authentication

- `ApiKey` (API key in the ApiKey header)
  - The unique API key for the merchant. See [Prerequisites and onboarding](../../getting-started/prerequisites-and-onboarding.md) for where to find it.

## Query parameters

- `siteCode` (string, required) - A unique code for the each of the merchant's sites. A site code is generated when adding a site in the Ozow merchant admin section.
- `bankReference` (string, required) - The reference returned by Create Unique Reference or Create Static Reference.

## Responses

### 200 OK

- `bankName` (string, required, max length 50) - Name of the bank the account is held at.
- `branchCode` (string, required, max length 10) - The destination branch code for the account
- `accountNumber` (string, required, max length 20) - The Ozow account number to use for deposit
- `publicRecipientName` (string, max length 50) - The name of the public recipient if applicable (depending whether a bankId was passed in the original request)
- `beneficiaryReference` (string, required, max length 20) - The reference to be used for the deposit

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