Skip to main content
GET
/
v1
/
accounts
JavaScript
import FingoPay from '@fingoafrica/fingo-pay';

const client = new FingoPay({
  apiKey: process.env['FINGO_PAY_API_KEY'], // This is the default and can be omitted
});

const accounts = await client.accounts.list();

console.log(accounts.data);
{
  "status": "success",
  "message": "Accounts fetched",
  "data": {
    "items": [
      {
        "type": "collections",
        "currency": "KES",
        "available": 9876543,
        "pending": 0,
        "status": "active",
        "default": true,
        "accountNo": "ACC-123456",
        "name": "Main Collections",
        "hostType": "fingo",
        "bankName": "Choice Bank",
        "bankCode": "80100",
        "branchCode": "001",
        "swiftCode": "CHKEKENX"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Use your API key as a Bearer token. Example: Authorization: Bearer sk_live_...

Query Parameters

type
enum<string>

Filter accounts by type.

Available options:
collections,
payouts

Response

Accounts fetched successfully

status
string
required
Example:

"success"

message
string
required
Example:

"Accounts fetched"

data
object
required