Get A Subscription Details

GET

/organization/billing/subscriptions/{subscriptionID}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api-staging.tenbyte.io/v1/organization/billing/subscriptions/subs_01K8ST605RC75CGT50S57S9F33' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "data": {
        "current_period_end": "2025-11-22T09:44:02Z",
        "plan": {
            "id": "plan_01K6SGSWZYWAVYXBZKJZJX7ZZR",
            "lookup_key": "basic",
            "name": "Basic",
            "description": "Basic tier with moderate AI usage limits",
            "status": "published",
            "created_at": "2025-10-05T06:26:34.622423Z",
            "updated_at": "2025-10-05T06:26:34.622423Z",
            "prices": [
                {
                    "created_at": "2025-10-05T06:26:34.622744Z",
                    "updated_at": "2025-10-05T06:26:34.622744Z",
                    "id": "price_01K6SGSWZYWAVYXBZKK0XV3S88",
                    "currency": "usd",
                    "billing_cadence": "RECURRING",
                    "billing_model": "FLAT_FEE",
                    "billing_period": "MONTHLY",
                    "status": "published",
                    "type": "FIXED",
                    "display_amount": "$10",
                    "amount": 10,
                    "billing_period_count": 1
                }
            ],
            "entitlements": [
                {
                    "usage_limit": 1,
                    "id": "ent_01K85H318FQAGJT0EMTC7RK7WV",
                    "feature_id": "feat_01K6SGSWZMMAPHPNNCQ9A1CZQ8",
                    "status": "published"
                }
            ]
        },
        "version": 1,
        "created_at": "2025-10-22T09:44:08.1794Z",
        "current_period_start": "2025-10-22T09:44:02.049Z",
        "start_date": "2025-10-22T09:44:02.049Z",
        "updated_at": "2025-10-22T09:44:08.1794Z",
        "id": "subs_01K85MVVQ9BYVG67ZQ8E5NFHMM",
        "billing_cadence": "RECURRING",
        "currency": "usd",
        "billing_cycle": "anniversary",
        "plan_id": "plan_01K6SGSWZYWAVYXBZKJZJX7ZZR",
        "customer_id": "cust_01K82R21F2BMKZ20R2J3M15SJ9",
        "status": "published",
        "billing_period": "MONTHLY",
        "subscription_status": "active",
        "pause_status": "none",
        "billing_period_count": 1
    },
    "message": "Subscription fetched successfully.",
    "success": true
}

Modified at 2025-11-13 10:18:23

Get Current Active Subscription

Update A Subscription