List features

You can retrieve a list of all available features in Gravv. The endpoint behavior depends on whether you include a customer ID in your request.

List all available features

To see all features that Gravv supports, call the Get features endpoint without the customer_id query parameter:

curl --request GET \
     --url https://api.gravv.xyz/v1/risk/features \
     --header 'Api-Key: <Api Key>'

The response returns all available features with activated set to false:

{
  "data": {
    "customer_id": null,
    "features": [
      {
        "feature_id": "usd_account",
        "name": "USD Account",
        "description": "Create and manage USD currency accounts",
        "activated": false
      },
      {
        "feature_id": "eur_account",
        "name": "EUR Account",
        "description": "Create and manage EUR currency accounts",
        "activated": false
      },
      {
        "feature_id": "gbp_account",
        "name": "GBP Account",
        "description": "Create and manage GBP currency accounts",
        "activated": false
      },
      {
        "feature_id": "international_transfers",
        "name": "Payout",
        "description": "Send and receive international wire transfers",
        "activated": false
      }
    ]
  },
  "error": null
}

List features for a specific customer

To see which features are activated for a specific customer, include the customer_id query parameter:

curl --request GET \
     --url 'https://api.gravv.xyz/v1/risk/features?customer_id=302dabcb-d4fd-4a00-a80b-afad70982614' \
     --header 'Api-Key: <Api Key>'

The response returns all features, but features that are activated for the specified customer will have activated set to true:

{
  "data": {
    "customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
    "features": [
      {
        "feature_id": "usd_account",
        "name": "USD Account",
        "description": "Create and manage USD currency accounts",
        "activated": true
      },
      {
        "feature_id": "eur_account",
        "name": "EUR Account",
        "description": "Create and manage EUR currency accounts",
        "activated": true
      },
      {
        "feature_id": "gbp_account",
        "name": "GBP Account",
        "description": "Create and manage GBP currency accounts",
        "activated": false
      },
      {
        "feature_id": "international_transfers",
        "name": "Payout",
        "description": "Send and receive international wire transfers",
        "activated": false
      }
    ]
  },
  "error": null
}

In this example, the customer has activated USD accounts and EUR accounts, but hasn't yet activated GBP accounts or international transfers.

Understanding the response

Each feature in the response contains:

Field	Description
feature_id	Unique identifier for the feature
name	Display name of the feature
description	Brief description of what the feature enables
activated	Whether the feature is currently activated for the customer