List Features

Returns all features defined in a project, including countable data for usage-based and limit-type features.

Endpoint

GET /api/v1/projects/{slug}/features

Authentication

Authorization

string

required

Bearer token with your API key. Requires read or read_write permission.

Path Parameters

slug

string

required

The project’s URL-friendly slug identifier.

Response

features

array

List of feature objects.

Show Feature object

number

Unique feature ID

name

string

Feature display name

description

string

Feature description

basePrice

number

Base price for this feature

featureType

string

One of "Standart", "Limits", or "Usage Based"

isCountable

boolean

Whether this feature has countable/usage data

countableData

object

Usage-related configuration (present when isCountable is true)

countableData.usageCount

number

Default usage count or limit value

countableData.condition

string

Condition label (e.g. "Up to", "Unlimited")

countableData.countPrice

number

Price per unit of usage

countableData.eventAggregationMethod

string

How usage events are aggregated (e.g. "count", "sum")

createdAt

string

ISO 8601 creation timestamp

updatedAt

string

ISO 8601 last-updated timestamp

Example

curl https://cuprice.io/api/v1/projects/my-saas-app/features \
  -H "Authorization: Bearer cpk_your_key_here"

{
  "features": [
    {
      "id": 101,
      "name": "AI Prompts",
      "description": "Monthly AI prompt allowance",
      "basePrice": 10,
      "featureType": "Limits",
      "isCountable": true,
      "countableData": {
        "usageCount": 500,
        "condition": "Up to",
        "countPrice": 0.02,
        "eventAggregationMethod": "count"
      },
      "createdAt": "2025-09-15T10:35:00.000Z",
      "updatedAt": "2025-09-15T10:35:00.000Z"
    },
    {
      "id": 102,
      "name": "Team Members",
      "description": "Number of team seats included",
      "basePrice": 5,
      "featureType": "Standart",
      "isCountable": false,
      "countableData": null,
      "createdAt": "2025-09-15T10:36:00.000Z",
      "updatedAt": "2025-09-15T10:36:00.000Z"
    },
    {
      "id": 103,
      "name": "API Calls",
      "description": "Monthly API request quota",
      "basePrice": 15,
      "featureType": "Usage Based",
      "isCountable": true,
      "countableData": {
        "usageCount": 10000,
        "condition": "Up to",
        "countPrice": 0.001,
        "eventAggregationMethod": "count"
      },
      "createdAt": "2025-09-15T10:37:00.000Z",
      "updatedAt": "2025-09-15T10:37:00.000Z"
    }
  ]
}

Errors

Status	Description
`401`	Invalid or missing API key
`404`	Project with the given slug not found

Overview

Public Endpoints

API v1 — Projects

API v1 — Features

API v1 — Plans

API v1 — Plan Features

Endpoint

Authentication

Path Parameters

Response

Example

Errors

​Endpoint

​Authentication

​Path Parameters

​Response

​Example

​Errors

Endpoint

Authentication

Path Parameters

Response

Example

Errors