List available features

Retrieve features based on the provided parameters. If you omit customer_id from the request, the endpoint returns all available features and their requirements. If you include customer_id, the endpoint returns the customer’s features and their activation status.

GET/v1/risk/features

Query Parameters

Optional customer ID. When provided, the response includes features specific to that customer along with their activation status. When omitted, or if the customer ID isn’t found, the response returns the global list of available features.

ISO 3166-1 alpha-2 country code. When provided, the response is filtered to features available in that country. Can be combined with customer_id to get country-specific features for a customer.

Filter features by activation status

Possible values: active, inactive, all

Responses

Status	Description
`200`	Features retrieved successfully
`400`	Bad request - Invalid or missing required data
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Customer not eligible
`404`	Feature or customer not found

200 response

Unique identifier for the customer

List of available features with their requirements

Unique identifier for the feature

Human-readable name of the feature

Detailed explanation of the feature

Whether the feature is currently activated for the customer

{
"data": {
"customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
"features": [
  {
    "feature_id": "crypto_wallet",
    "name": "Wallet",
    "description": "Create and manage wallets",
    "activated": false
  },
  {
    "feature_id": "eur_account",
    "name": "EUR Account",
    "description": "Create and manage EUR currency accounts",
    "activated": false
  },
  {
    "feature_id": "international_transfers",
    "name": "Payout",
    "description": "Send and receive international wire transfers",
    "activated": false
  },
  {
    "feature_id": "usd_account",
    "name": "USD Account",
    "description": "Create and manage USD currency accounts",
    "activated": false
  },
  {
    "feature_id": "virtual_cards",
    "name": "Cards",
    "description": "Issue and manage debit/credit cards",
    "activated": false
  }
]
},
"error": null
}

{
"data": {
"customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
"features": [
  {
    "feature_id": "crypto_wallet",
    "name": "Wallet",
    "description": "Create and manage wallets",
    "activated": true
  },
  {
    "feature_id": "eur_account",
    "name": "EUR Account",
    "description": "Create and manage EUR currency accounts",
    "activated": true
  },
  {
    "feature_id": "international_transfers",
    "name": "Payout",
    "description": "Send and receive international wire transfers",
    "activated": false
  },
  {
    "feature_id": "usd_account",
    "name": "USD Account",
    "description": "Create and manage USD currency accounts",
    "activated": true
  },
  {
    "feature_id": "virtual_cards",
    "name": "Cards",
    "description": "Issue and manage debit/credit cards",
    "activated": true
  }
]
},
"error": null
}

400 response

Always null for error responses

Human-readable error message

{
"data": null,
"error": "annual_remuneration is required and must be a number"
}

{
"data": null,
"error": "estimated_monthly_limit must be a positive number"
}

401 response

Always null for error responses

Human-readable error message

{
"data": null,
"error": "Invalid or missing Api-Key header. Api-Key is required!"
}

403 response

Always null for error responses

Human-readable error message

{
"data": null,
"error": "Customer does not meet eligibility requirements"
}

404 response

Always null for error responses

Human-readable error message

{
"data": null,
"error": "Feature not found"
}

Authorization

ApiKeyAuth

Was this page helpful?