Get a Subscription
Developing
GET
/subscriptions/{subscriptionID}
Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-staging.tenbyte.io/v1/subscriptions/subs_01K85MVVQ9BYVG67ZQ8E5NFHMM' \
--header 'x-api-key: sk_01K82J4TM641Z11DVXN37B7YQ4' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"id": "subs_01K85MVVQ9BYVG67ZQ8E5NFHMM",
"customer_id": "cust_01K82R21F2BMKZ20R2J3M15SJ9",
"plan_id": "plan_01K6SGSWZYWAVYXBZKJZJX7ZZR",
"subscription_status": "active",
"currency": "usd",
"billing_anchor": "2025-10-22T09:44:02.049Z",
"billing_cycle": "anniversary",
"start_date": "2025-10-22T09:44:02.049Z",
"current_period_start": "2025-10-22T09:44:02.049Z",
"current_period_end": "2025-11-22T09:44:02Z",
"cancel_at": null,
"cancel_at_period_end": false,
"trial_start": null,
"trial_end": null,
"billing_cadence": "RECURRING",
"billing_period": "MONTHLY",
"billing_period_count": 1,
"version": 1,
"environment_id": "env_01K6SGSWZCAT8PHRJGBVJWWEPC",
"pause_status": "none",
"overage_factor": "1",
"payment_behavior": "default_active",
"collection_method": "charge_automatically",
"gateway_payment_method_id": "",
"line_items": [
{
"id": "subs_line_01K85MVVQFW2BG4VY071Z2ZGHQ",
"subscription_id": "subs_01K85MVVQ9BYVG67ZQ8E5NFHMM",
"customer_id": "cust_01K82R21F2BMKZ20R2J3M15SJ9",
"entity_id": "plan_01K6SGSWZYWAVYXBZKJZJX7ZZR",
"entity_type": "plan",
"plan_display_name": "Basic",
"price_id": "price_01K6SGSWZYWAVYXBZKK0XV3S88",
"price_type": "FIXED",
"price_unit_id": "",
"price_unit": "",
"display_name": "Basic",
"quantity": "1",
"currency": "usd",
"billing_period": "MONTHLY",
"invoice_cadence": "ADVANCE",
"trial_period": 0,
"start_date": "2025-10-22T09:44:02.049Z",
"end_date": "0001-01-01T00:00:00Z",
"environment_id": "env_01K6SGSWZCAT8PHRJGBVJWWEPC",
"tenant_id": "tenant_01K6SGSWX68JD041NDQZ7VP1ES",
"status": "published",
"created_at": "2025-10-22T09:44:08.184969Z",
"updated_at": "2025-10-22T09:44:08.184969Z",
"created_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"updated_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ"
}
],
"customer_timezone": "UTC",
"proration_behavior": "none",
"tenant_id": "tenant_01K6SGSWX68JD041NDQZ7VP1ES",
"status": "published",
"created_at": "2025-10-22T09:44:08.1794Z",
"updated_at": "2025-10-22T09:44:08.1794Z",
"created_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"updated_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"plan": {
"id": "plan_01K6SGSWZYWAVYXBZKJZJX7ZZR",
"name": "Basic",
"lookup_key": "basic",
"description": "Basic tier with moderate AI usage limits",
"environment_id": "env_01K6SGSWZCAT8PHRJGBVJWWEPC",
"metadata": null,
"display_order": 0,
"tenant_id": "tenant_01K6SGSWX68JD041NDQZ7VP1ES",
"status": "published",
"created_at": "2025-10-05T06:26:34.622423Z",
"updated_at": "2025-10-05T06:26:34.622423Z",
"created_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"updated_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"prices": [
{
"id": "price_01K6SGSWZYWAVYXBZKK0XV3S88",
"amount": "10",
"display_amount": "$10",
"currency": "usd",
"price_unit_type": "FIAT",
"price_unit_amount": "0",
"conversion_rate": "0",
"type": "FIXED",
"billing_period": "MONTHLY",
"billing_period_count": 1,
"billing_model": "FLAT_FEE",
"billing_cadence": "RECURRING",
"invoice_cadence": "ADVANCE",
"trial_period": 0,
"tier_mode": "",
"tiers": null,
"price_unit_tiers": null,
"meter_id": "",
"lookup_key": "",
"description": "Basic tier with moderate usage",
"transform_quantity": {},
"metadata": {},
"environment_id": "env_01K6SGSWZCAT8PHRJGBVJWWEPC",
"entity_type": "PLAN",
"entity_id": "plan_01K6SGSWZYWAVYXBZKJZJX7ZZR",
"start_date": "2025-10-05T06:26:34.622741Z",
"tenant_id": "tenant_01K6SGSWX68JD041NDQZ7VP1ES",
"status": "published",
"created_at": "2025-10-05T06:26:34.622744Z",
"updated_at": "2025-10-05T06:26:34.622744Z",
"created_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"updated_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ"
}
],
"entitlements": [
{
"id": "ent_01K85H318FQAGJT0EMTC7RK7WV",
"entity_type": "PLAN",
"entity_id": "plan_01K6SGSWZYWAVYXBZKJZJX7ZZR",
"feature_id": "feat_01K6SGSWZMMAPHPNNCQ9A1CZQ8",
"feature_type": "metered",
"is_enabled": true,
"usage_limit": 1,
"usage_reset_period": "MONTHLY",
"is_soft_limit": false,
"static_value": "",
"environment_id": "env_01K6SGSWZCAT8PHRJGBVJWWEPC",
"display_order": 0,
"tenant_id": "tenant_01K6SGSWX68JD041NDQZ7VP1ES",
"status": "published",
"created_at": "2025-10-22T08:38:08.911939Z",
"updated_at": "2025-10-22T08:38:08.911939Z",
"created_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"updated_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"feature": {
"id": "feat_01K6SGSWZMMAPHPNNCQ9A1CZQ8",
"name": "LLM Usage",
"lookup_key": "llm_usage",
"description": "LLM API usage and requests",
"meter_id": "meter_01K6SGSWZGQ2WSP8Y9TQ2SA2WD",
"metadata": null,
"type": "metered",
"unit_singular": "",
"unit_plural": "",
"environment_id": "env_01K6SGSWZCAT8PHRJGBVJWWEPC",
"tenant_id": "tenant_01K6SGSWX68JD041NDQZ7VP1ES",
"status": "published",
"created_at": "2025-10-05T06:26:34.612035Z",
"updated_at": "2025-10-05T06:26:34.612035Z",
"created_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"updated_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"meter": {
"id": "meter_01K6SGSWZGQ2WSP8Y9TQ2SA2WD",
"name": "LLM Usage",
"tenant_id": "tenant_01K6SGSWX68JD041NDQZ7VP1ES",
"event_name": "llm_usage",
"aggregation": {
"type": "SUM",
"field": "value"
},
"filters": [
{
"key": "model",
"values": [
"gpt-4",
"gpt-3.5-turbo",
"claude-3",
"claude-2",
"llama-2",
"palm-2"
]
}
],
"reset_usage": "",
"created_at": "2025-10-05T06:26:34.608211Z",
"updated_at": "2025-10-05T06:26:34.608211Z",
"status": "published"
}
},
"plan_id": "plan_01K6SGSWZYWAVYXBZKJZJX7ZZR"
}
]
},
"customer": {
"id": "cust_01K82R21F2BMKZ20R2J3M15SJ9",
"external_id": "75306b95-00dd-4eec-bb93-e4192ae1fe9f",
"name": "Apple 2",
"email": "test@gmail.com",
"address_line1": "Dhaka, Bangladesh",
"address_line2": "Dhaka, bangladesh",
"address_city": "Dhaka",
"address_state": "Dhaka",
"address_postal_code": "1200",
"address_country": "BD",
"metadata": {
"bill_as": "Individual",
"stripe_customer_id": "cus_TH7dM8VDUc7Q74"
},
"environment_id": "env_01K6SGSWZCAT8PHRJGBVJWWEPC",
"tenant_id": "tenant_01K6SGSWX68JD041NDQZ7VP1ES",
"status": "published",
"created_at": "2025-10-21T06:42:13.090128Z",
"updated_at": "2025-10-21T06:49:20.213924Z",
"created_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ",
"updated_by": "user_01K6SGSWZ3CEY7V5CSZK25CAJJ"
}
}Modified at 2025-10-22 10:10:24