Quickstart

The Interstellas API authenticates every request with an API key and secret — there’s no separate sign-in step. Generate a credential pair from the dashboard and you’re ready to call any endpoint.

Prerequisites

An Interstellas account — sign up at interstellas.stellasbank.com
An API key and secret from Settings → API Keys in the dashboard (use your stl_test_... secret while building against sandbox)
Your businessId — returned when you create a business or from listing businesses

Make an authenticated request

Every business endpoint requires three headers: your API key, your API secret, and your business ID.

curl -X GET https://sandbox.stellasbank.com/api/v1/clients/business/account-details \
  -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/business/account-details",
  {
    headers: {
      "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
      "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
      businessId: "YOUR_BUSINESS_ID",
    },
  }
);
const { data } = await res.json();

import requests

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

A successful response returns your business’s account details:

{
  "status": true,
  "message": "Account details retrieved successfully",
  "data": {
    "accountNumber": "0123456789",
    "accountType": "current",
    "customerId": "cust_abc123",
    "businessId": "biz_xyz789",
    "accountBalance": "5000000"
  }
}

Next steps

Authentication

Understand key formats, live vs. test environments, and how to manage credentials.

API Reference

Browse every available endpoint.

Errors

Learn how errors are structured and how to handle them.

Pagination

Work with list endpoints that return paginated results.

Get started

Essentials

Prerequisites

Make an authenticated request

Next steps

Authentication

API Reference

Errors

Pagination

​Prerequisites

​Make an authenticated request

​Next steps

Authentication

API Reference

Errors

Pagination

Prerequisites

Make an authenticated request

Next steps