Fetch Sub-Entity Profile By Id

This endpoint retrieves the full profile of a specific sub-entity by its ID, including its balance information across all registered blockchain assets. Access is scoped to sub-entities belonging to the institution associated with the auth token.

GET {{host}}/api/v1/institutions/profile/sub-entity/{id}

Path Parameter

#	Field Name	Data Type	Required	Description
1	`id`	Integer	Yes	Unique internal ID of the sub-entity to retrieve

Sample Request

GET {{host}}/api/v1/institutions/profile/sub-entity/78

Response Message Field Description

#	Field Name	Description
1	`success`	Indicates whether the request was successful (`true` for success)
2	`responseCode`	HTTP-like response code (e.g. `200` for success)
3	`responseMessage`	Human-readable result message (e.g. `Success`)
4	`data`	Object containing the sub-entity's full profile and balance details
4.1	`data.id`	Unique internal identifier of the sub-entity
4.2	`data.institutionId`	Unique internal ID of the parent institution
4.3	`data.institutionCode`	Alphanumeric code identifying the parent institution
4.4	`data.name`	Display name of the sub-entity
4.5	`data.email`	Contact email address of the sub-entity
4.6	`data.vaultId`	Vault identifier assigned to the sub-entity
4.7	`data.kycStatus`	Current KYC verification status
4.8	`data.kycLevel`	KYC level of the sub-entity
4.9	`data.enabled`	Whether the sub-entity is currently active
4.10	`data.balanceInformation`	Object containing asset balance and metadata details
4.10.1	`data.balanceInformation.balances`	Array of balance objects, one per registered asset
4.10.1.1	`data.balanceInformation.balances[].institutionId`	Unique internal ID of the parent institution
4.10.1.2	`data.balanceInformation.balances[].subInstitutionId`	Unique internal ID of the sub-entity
4.10.1.3	`data.balanceInformation.balances[].vaultId`	Vault identifier for this asset
4.10.1.4	`data.balanceInformation.balances[].assetId`	Unique identifier of the blockchain asset
4.10.1.5	`data.balanceInformation.balances[].address`	Blockchain wallet address for this asset
4.10.1.6	`data.balanceInformation.balances[].availableBalance`	Current available balance for the asset
4.10.1.7	`data.balanceInformation.balances[].frozenBalance`	Amount of the asset currently frozen
4.10.2	`data.balanceInformation.assetInfo`	Array of asset metadata objects
4.10.2.1	`data.balanceInformation.assetInfo[].id`	Unique identifier of the asset
4.10.2.2	`data.balanceInformation.assetInfo[].displayName`	Human-readable name of the asset
4.10.2.3	`data.balanceInformation.assetInfo[].displaySymbols`	Display ticker symbol (e.g. cNGN)
4.10.2.4	`data.balanceInformation.assetInfo[].onChainDecimals`	Number of decimal places used on-chain
4.10.2.5	`data.balanceInformation.assetInfo[].blockchainId`	Blockchain network identifier
4.10.2.6	`data.balanceInformation.assetInfo[].blockchainDisplayName`	Display name of the blockchain network

Sample Response (Success)

{
  "success": true,
  "responseCode": "200",
  "responseMessage": "Success",
  "data": {
    "id": 78,
    "institutionId": 3,
    "institutionCode": "ACME001",
    "name": "Acme Sub-entity Alpha",
    "email": "[email protected]",
    "vaultId": "94",
    "kycStatus": "APPROVED",
    "kycLevel": "TIER_2",
    "enabled": true,
    "balanceInformation": {
      "balances": [
        {
          "institutionId": 3,
          "subInstitutionId": "78",
          "vaultId": "94",
          "assetId": "CNGN_B75VRLGX_8GWM",
          "address": "0x632E8..............",
          "availableBalance": "1200.00",
          "frozenBalance": "0"
        }
      ],
      "assetInfo": [
        {
          "id": "CNGN_B75VRLGX_8GWM",
          "displayName": "Cardano Nigerian Naira",
          "displaySymbols": "cNGN",
          "onChainDecimals": 6,
          "blockchainId": "BASE_TEST",
          "blockchainDisplayName": "Base Testnet"
        }
      ]
    }
  }
}

Sample Response (Failure)

{
  "success": false,
  "responseCode": "404",
  "responseMessage": "Entity Not Found"
}