---
title: "Get Subscription Info"
method: GET
path: "/conglomerates/{conglomerate_id}/subscription"
tags: ["subscriptions"]
---

# Get Subscription Info

`GET /conglomerates/{conglomerate_id}/subscription`

Get current subscription info.

## Path parameters

- `conglomerate_id` string, uuid, required

## Response `200`

Successful Response

- SubscriptionInfoResponse
  - `plan_tier` string, required
  - `credit_balance` number, required
  - `credits_per_month` integer, nullable, required
  - `current_period_start` string, nullable, required
  - `current_period_end` string, nullable, required
  - `subscription_status` string, nullable, required
  - `pending_downgrade_to` integer, nullable
  - `max_daily_credits` number, required
  - `credits_used_today` number, required
  - `auto_topup_enabled` boolean, required
  - `auto_topup_credits` integer, nullable, required
  - `auto_topup_disabled_reason` string, nullable, required
  - `auto_topup_threshold` number, required
  - `notice` SubscriptionNoticeResponse — The ONE money notice the chat rail may show (spec CREDIT_NOTICES §6.3). Picked server-side (use_cases/credits/notices.py) so the thresholds are never re-derived in TS. ``episode_anchor`` is the client's dismissal key: the last time credits were added, so a dismissed notice re-arms exactly when the balance was refilled and drained again.
    - `kind` 'credits_low' | 'credits_critical' | 'founder_plan', required
    - `credits` number, required
    - `has_plan` boolean, required
    - `refill_at` string, nullable, required
    - `auto_topup_armed` boolean, required
    - `episode_anchor` string, nullable, required
    - `ship_product_floor` number, required
  - `plan_expires_at` string, nullable
  - `light_available` boolean
  - `light_offered` boolean
  - `cancel_at_period_end` boolean
  - `dormant_demand_count` integer, nullable
  - `paying_subscribers` integer
  - `gtm_call` GtmCallResponse, required
    - `url` string, nullable, required
    - `eligible` 'founder' | 'hint' | 'none', required
    - `booked_at` string, nullable, required
    - `dismissed_until` string, nullable, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `c4109d3755e1` — 1 info
  - added the optional property `light_offered` to the response with the `200` status
- **2026-09-17** `fdb61f8c4234` — 1 info
  - added the optional property `paying_subscribers` to the response with the `200` status
- **2026-09-10** `22ea25f84a15` — 1 info
  - added the required property `gtm_call` to the response with the `200` status

[Change history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/conglomerates/:conglomerate_id/subscription/get.md)

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) · [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nanocorp/apis/nanocorp-api/revisions/113752ab03f9?raw)