Affinity API 1.0 Help

Banks

To transfer money from an Affinity account, you will need the recipient’s bank account information or mobile money phone number. The most up-to-date details of all the institutions we support can be found in our list of bank APIs.

By specifying the type of institution, you can further filter the list.

The two types of institutions are:

type

Description

mobile_money

These include all mobile money service providers such as MTN Mobile Money, AirtelTigo, etc

bank

These include all supported banks

Making the Request

GET method/utilities/banks

Retrieve the list of supported banks

Request parameters

Responses

[ { "id": "example", "name": "example", "swiftCode": "example", "gipCode": "example" } ]
[ { "message": "example", "code": "example", "field": "example" } ]
{ "message": "example" }

Field

Description

1.

id

Unique identifier for the institution

2.

name

Name of the institution

3.

swiftCode

SWIFT code of the institution if available

4.

gipCode

GIP routing code

Sample response

The Response will be an array of banks:

[ { "id": "09c9ba97eee034d4f6d2", "name": "Zenith Bank Ghana Limited", "swiftCode": "ZTEST01", "gipCode": "999222" } ]
Last modified: 27 August 2025