Feature KPIs

Analyse feature adoption, revenue generation, and distribution across your platform. Feature KPIs provide comprehensive insights into which services are driving value and how they’re performing across your customer base.

Available KPIs

Feature Summary

Returns total feature counts and basic statistics.

Endpoint

GET /backend/kpi/features/

Example Request

curl -X GET "https://companyname.callstats.net/backend/kpi/features/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Example Response

[
  {
    "feature_customer_count": 2847,
    "feature_number_count": 4250,
    "feature_count": 12847
  }
]

Feature Charges Summary

Provides financial overview of all features including total charges by currency.

Endpoint

GET /backend/kpi/features/charges/

Example Request

curl -X GET "https://companyname.callstats.net/backend/kpi/features/charges/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Example Response

[
  {
    "feature_currency": "GBP",
    "feature_customer_count": 2500,
    "feature_number_count": 3800,
    "feature_count": 9500,
    "feature_connection_charge": 12500.00,
    "feature_service_charge": 45678.50,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "EUR",
    "feature_customer_count": 347,
    "feature_number_count": 450,
    "feature_count": 1750,
    "feature_connection_charge": 3200.00,
    "feature_service_charge": 12345.00,
    "feature_service_charge_interval": "month"
  }
]

Features by Status

Groups features by their operational status.

Endpoint

GET /backend/kpi/features/byStatus/

Example Request

curl -X GET "https://companyname.callstats.net/backend/kpi/features/byStatus/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Example Response

[
  {
    "feature_status": "active",
    "feature_customer_count": 2800,
    "feature_number_count": 4100,
    "feature_count": 11250
  },
  {
    "feature_status": "suspended",
    "feature_customer_count": 95,
    "feature_number_count": 120,
    "feature_count": 247
  },
  {
    "feature_status": "dropped",
    "feature_customer_count": 450,
    "feature_number_count": 680,
    "feature_count": 1350
  }
]

Feature Charges by Status

Combines status information with revenue data.

Endpoint

GET /backend/kpi/features/chargesByStatus/

Example Request

curl -X GET "https://companyname.callstats.net/backend/kpi/features/chargesByStatus/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Example Response

[
  {
    "feature_currency": "GBP",
    "feature_status": "active",
    "feature_customer_count": 2400,
    "feature_number_count": 3600,
    "feature_count": 9250,
    "feature_connection_charge": 12000.00,
    "feature_service_charge": 45678.50,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "EUR",
    "feature_status": "active",
    "feature_customer_count": 340,
    "feature_number_count": 440,
    "feature_count": 1700,
    "feature_connection_charge": 3100.00,
    "feature_service_charge": 12345.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "GBP",
    "feature_status": "suspended",
    "feature_customer_count": 80,
    "feature_number_count": 100,
    "feature_count": 200,
    "feature_connection_charge": 0.00,
    "feature_service_charge": 0.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "EUR",
    "feature_status": "suspended",
    "feature_customer_count": 15,
    "feature_number_count": 20,
    "feature_count": 47,
    "feature_connection_charge": 0.00,
    "feature_service_charge": 0.00,
    "feature_service_charge_interval": "month"
  }
]

Features by Dealer

Shows feature distribution across different dealer channels.

Endpoint

GET /backend/kpi/features/byDealer/

Example Request

curl -X GET "https://companyname.callstats.net/backend/kpi/features/byDealer/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Example Response

[
  {
    "feature_dealer": "DEALER01",
    "feature_customer_count": 1200,
    "feature_number_count": 1800,
    "feature_count": 4500
  },
  {
    "feature_dealer": "DEALER02",
    "feature_customer_count": 850,
    "feature_number_count": 1300,
    "feature_count": 3200
  },
  {
    "feature_dealer": "DIRECT",
    "feature_customer_count": 1400,
    "feature_number_count": 2100,
    "feature_count": 5147
  }
]

Feature Charges by Dealer

Provides revenue breakdown by dealer channel.

Endpoint

GET /backend/kpi/features/chargesByDealer/

Example Request

curl -X GET "https://companyname.callstats.net/backend/kpi/features/chargesByDealer/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Example Response

[
  {
    "feature_currency": "GBP",
    "feature_dealer": "DEALER01",
    "feature_customer_count": 1100,
    "feature_number_count": 1650,
    "feature_count": 3800,
    "feature_connection_charge": 5000.00,
    "feature_service_charge": 18500.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "EUR",
    "feature_dealer": "DEALER01",
    "feature_customer_count": 100,
    "feature_number_count": 150,
    "feature_count": 400,
    "feature_connection_charge": 800.00,
    "feature_service_charge": 4500.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "GBP",
    "feature_dealer": "DEALER02",
    "feature_customer_count": 750,
    "feature_number_count": 1150,
    "feature_count": 2700,
    "feature_connection_charge": 3500.00,
    "feature_service_charge": 12000.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "EUR",
    "feature_dealer": "DEALER02",
    "feature_customer_count": 80,
    "feature_number_count": 120,
    "feature_count": 300,
    "feature_connection_charge": 600.00,
    "feature_service_charge": 3500.00,
    "feature_service_charge_interval": "month"
  }
]

Features by Type

Categorises features by their type/product code.

Endpoint

GET /backend/kpi/features/byType/

Example Request

curl -X GET "https://companyname.callstats.net/backend/kpi/features/byType/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Example Response

[
  {
    "feature_type": "VOICEMAIL",
    "feature_customer_count": 1200,
    "feature_number_count": 1800,
    "feature_count": 3500
  },
  {
    "feature_type": "CALLFWD",
    "feature_customer_count": 950,
    "feature_number_count": 1400,
    "feature_count": 2800
  },
  {
    "feature_type": "HUNTGROUP",
    "feature_customer_count": 380,
    "feature_number_count": 580,
    "feature_count": 1500
  },
  {
    "feature_type": "IVR",
    "feature_customer_count": 250,
    "feature_number_count": 400,
    "feature_count": 850
  }
]

Feature Charges by Type

Provides revenue analysis by feature type.

Endpoint

GET /backend/kpi/features/chargesByType/

Example Request

curl -X GET "https://companyname.callstats.net/backend/kpi/features/chargesByType/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Example Response

[
  {
    "feature_currency": "GBP",
    "feature_type": "VOICEMAIL",
    "feature_customer_count": 1100,
    "feature_number_count": 1650,
    "feature_count": 3200,
    "feature_connection_charge": 1600.00,
    "feature_service_charge": 7000.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "EUR",
    "feature_type": "VOICEMAIL",
    "feature_customer_count": 100,
    "feature_number_count": 150,
    "feature_count": 300,
    "feature_connection_charge": 150.00,
    "feature_service_charge": 1750.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "GBP",
    "feature_type": "HUNTGROUP",
    "feature_customer_count": 350,
    "feature_number_count": 530,
    "feature_count": 1400,
    "feature_connection_charge": 7000.00,
    "feature_service_charge": 15000.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "EUR",
    "feature_type": "HUNTGROUP",
    "feature_customer_count": 30,
    "feature_number_count": 50,
    "feature_count": 100,
    "feature_connection_charge": 500.00,
    "feature_service_charge": 3750.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "GBP",
    "feature_type": "IVR",
    "feature_customer_count": 240,
    "feature_number_count": 380,
    "feature_count": 800,
    "feature_connection_charge": 4000.00,
    "feature_service_charge": 12750.00,
    "feature_service_charge_interval": "month"
  },
  {
    "feature_currency": "EUR",
    "feature_type": "IVR",
    "feature_customer_count": 10,
    "feature_number_count": 20,
    "feature_count": 50,
    "feature_connection_charge": 250.00,
    "feature_service_charge": 3187.50,
    "feature_service_charge_interval": "month"
  }
]

Filtering Options

Refine your results using these filter parameters:

Parameter	Type	Description	Example
active	boolean	Include only active features	`active=true`
excludeDropped	boolean	Exclude dropped features (alias for active)	`excludeDropped=true`
dropped	boolean	Include only dropped features	`dropped=true`
dealerCode	string	Filter by specific dealer code	`dealerCode=DEALER01`
featureType	string	Filter by feature type/product code	`featureType=VOICEMAIL`

Filter Examples

Active Features with Charges

curl -X GET "https://companyname.callstats.net/backend/kpi/features/charges/?active=true" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Specific Feature Type Analysis

curl -X GET "https://companyname.callstats.net/backend/kpi/features/?featureType=HUNTGROUP" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Dealer-Specific Feature Revenue

curl -X GET "https://companyname.callstats.net/backend/kpi/features/chargesByType/?dealerCode=DEALER01" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Use Cases

Revenue Analysis

Track feature-based revenue streams:

# Overall feature revenue
curl -X GET "https://companyname.callstats.net/backend/kpi/features/charges/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

# Revenue by feature type
curl -X GET "https://companyname.callstats.net/backend/kpi/features/chargesByType/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Product Adoption Tracking

Monitor feature uptake and popularity:

# Feature type distribution
curl -X GET "https://companyname.callstats.net/backend/kpi/features/byType/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

# Active features by dealer
curl -X GET "https://companyname.callstats.net/backend/kpi/features/byDealer/?active=true" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Channel Analysis

Track feature distribution across sales channels:

# Feature counts by channel
curl -X GET "https://companyname.callstats.net/backend/kpi/features/byDealer/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

# Revenue by channel
curl -X GET "https://companyname.callstats.net/backend/kpi/features/chargesByDealer/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Profitability Analysis

Identify most valuable features:

# High-value feature types
curl -X GET "https://companyname.callstats.net/backend/kpi/features/chargesByType/?active=true" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

# Average revenue per feature by dealer
curl -X GET "https://companyname.callstats.net/backend/kpi/features/chargesByDealer/" \
  -H "Authorization: Bearer YOUR_KPI_KEY"

Best Practices

Revenue Monitoring - Track feature charges daily to identify billing issues early
Adoption Metrics - Monitor new feature uptake rates to assess product success
Channel Performance - Compare feature attachment rates across different sales channels
Product Mix - Ensure healthy distribution of feature types for business stability
Churn Prevention - Monitor dropped features as early warning of customer dissatisfaction

Common Feature Types

Examples of typical feature types in telephony platforms:

Core Features: Voicemail, Call Forwarding, Call Waiting
Advanced Features: Hunt Groups, IVR, Call Recording
Business Features: Conference Bridges, Call Queues, Analytics
Value-Added Services: Number Porting, Directory Listings, Enhanced Support

Customer KPIs - Analyse feature attachment rates per customer
Number KPIs - See features applied to specific number types
Invoice KPIs - Track feature revenue contribution to invoices

Feature KPIs

Available KPIs

Feature Summary

Feature Charges Summary

Features by Status

Feature Charges by Status

Features by Dealer

Feature Charges by Dealer

Features by Type

Feature Charges by Type

Filtering Options

Filter Examples

Use Cases

Revenue Analysis

Product Adoption Tracking

Channel Analysis

Profitability Analysis

Best Practices

Common Feature Types

Related KPIs