Skip to main content

Get Platform Settings

Returns the platform-wide settings. Any API key with the permission may read them; they are platform configuration, not node data. Only platform_owner_can_change_wallet can be changed through this API, see Update Platform Owner Can Change Wallet.

Required permission: platform-setting:view

Request​

GET /v2/admin/platform-settings

Headers​

NameDescription
AuthorizationRequired. Bearer <access_token>

Example​

curl --request GET \
--url '{{baseUrl}}/v2/admin/platform-settings' \
--header 'Authorization: Bearer <access_token>'

Response​

{
"on_premise": false,
"platform_owner_can_change_wallet": true,
"is_self_custody_wallet": false,
"distribution_market_id": null
}

Response Fields​

FieldTypeDescription
on_premisebooleanWhether the platform runs on-premise (no licensor above the platform). Read-only here.
platform_owner_can_change_walletbooleanWhether the platform owner may change its own wallet on setups created from now on. Each setup keeps the value it was created with, and Start Platform Owner Change checks the setup's copy.
is_self_custody_walletbooleanEnd-user wallet mode: true means users bring their own external wallets, false means the platform manages custody wallets for them. Read-only here.
distribution_market_idstring | nullThe configured distribution market id, or null when none is set. Read-only here.

Errors​

StatusCodeDescription
40010015The platform settings have not been created yet

See Errors for the error format and common codes.