Skip to main content
Use this endpoint to retrieve the primary account for your business in a single call, without needing to know the account number in advance. This is useful for initialising dashboards, pre-filling transfer forms, or identifying the default settlement destination in your integration. No request body is required. Endpoint 
GET https://baasapi.payrepmfb.com/api/v1/account/api/get_primary_account
Sandbox 
GET https://shogun-dev.xchangeboxng.com/api/v1/account/api/get_primary_account

​
Authentication

Include your Bearer token in the Authorization header: 
Authorization: Bearer <access_token>
Obtain a token from Generate Token.

​
Request body

None. This is a GET request with no body.

​
Selection logic

The API resolves your primary account using the following order:
  1. The account with account_class = "primary" — if you have explicitly designated a primary account.
  2. If no primary account exists, the endpoint falls back to the first account created for your business.
If you have multiple accounts and want a specific one returned here, contact Shogun support to designate a primary account for your business.

​
Example request

curl --request GET \
  --url https://baasapi.payrepmfb.com/api/v1/account/api/get_primary_account \
  --header 'Authorization: Bearer <access_token>'

​
Response

​
Success

​
status
boolean
true when the request succeeds.
​
response_code
string
"00" on success.
​
message
string
Human-readable result message.
​
data
object
The primary account object.
{
  "status": true,
  "response_code": "00",
  "message": "Success",
  "data": {
    "account_number": "7801234567",
    "account_name": "Main Pool Account",
    "account_type": "pool",
    "status": "active",
    "balance": "1500000.000000000",
    "last_balance_update": "2026-02-25T10:30:00Z"
  }
}

​
Error codes

CodeMeaning
00Success
41Customer not found — your API credentials are invalid