Get billers

The billers endpoint returns the bank codes you need when specifying a receiverBankCode or bankCode in transfer and payout requests.

Endpoint

GET /clients/settings/billers

Headers

string

required

Your public API key.

string

required

Your API secret. Use a stl_test_... value in sandbox, stl_live_... in production.

string

required

Your business ID.

Response

boolean

true on success.

string

Human-readable outcome.

array

Array of biller identifier strings representing supported bank codes.

Code examples

curl -X GET https://sandbox.stellasbank.com/api/v1/clients/settings/billers \
  -H "x-api-key: stl_c8e286ca55b0123e0b05da047494f585" \
  -H "x-api-secret: stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0" \
  -H "businessId: YOUR_BUSINESS_ID"

const res = await fetch(
  "https://sandbox.stellasbank.com/api/v1/clients/settings/billers",
  {
    headers: {
      "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
      "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
      businessId: "YOUR_BUSINESS_ID",
    },
  }
);
const { data } = await res.json();
const bankCodes = data.billers;

import requests

res = requests.get(
    "https://sandbox.stellasbank.com/api/v1/clients/settings/billers",
    headers={
        "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
        "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
        "businessId": "YOUR_BUSINESS_ID",
    },
)
bank_codes = res.json()["data"]["billers"]

Example response

{
  "status": true,
  "message": "Billers retrieved successfully",
  "data": {
    "billers": ["044", "058", "011", "033", "035", "070", "076", "232"]
  }
}

Overview

Members

Business

Virtual accounts

Funds

Bulk transfers

Disputes

Subscriptions

Payouts

Audit logs

Settings

Endpoint

Headers

Response

Code examples

Example response

​Endpoint

​Headers

​Response

​Code examples

​Example response

Endpoint

Headers

Response

Code examples

Example response