Skip to main content
GET
/
tenant
/
{tenantId}
/
assets
Get Tenant Assets
curl --request GET \
  --url https://api.example.com/tenant/{tenantId}/assets
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

Fetches the complete list of blockchain assets that are available and configured for use within the specified tenant’s environment. This includes native cryptocurrencies and tokens deployed across supported blockchains.

​
Input

  • tenantId (long, required) — The unique identifier of the tenant whose assets should be retrieved.
  • cancellationToken (optional) — Token for canceling the operation if needed.

​
Output

Returns an EmbeddedAssetListModel containing:
  • tenantId (string) — The tenant identifier as a string.
  • assets (array) — List of asset view models with details about each available asset including symbol, name, and availability status.

​
Examples

Request 
GET /api/tenants/1024/assets
Response (200 OK) 
{
  "tenantId": "1024",
  "assets": [
    {
      "id": 1,
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "isAvailable": true
    },
    {
      "id": 2,
      "name": "Ethereum",
      "symbol": "ETH",
      "decimals": 18,
      "isAvailable": true
    }
  ]
}

​
Errors

  • 400 Bad Request: Invalid tenant identifier format or validation failure.
  • 401 Unauthorized: Authentication credentials are missing or invalid.
  • 403 Forbidden: The authenticated user does not have permission to view assets for this tenant.
  • 404 Not Found: The specified tenant does not exist in the system.
  • 500 Internal Server Error: An unexpected error occurred on the server.

​
Notes

Only assets that have been explicitly configured and enabled for the tenant will be returned. Assets may be blockchain-native currencies (like ETH) or deployed smart contract tokens (like USDC, USDT).

Path Parameters

​
tenantId
integer<int64>
required

The unique identifier of the tenant.

Query Parameters

​
api-version
string | null

Response

Assets retrieved successfully.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{
  "tenantId": "1024",
  "assets": [
    {
      "id": 1,
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "isAvailable": true
    },
    {
      "id": 2,
      "name": "Ethereum",
      "symbol": "ETH",
      "decimals": 18,
      "isAvailable": true
    }
  ]
}