---
title: "List Company Subscriptions"
method: GET
path: "/companies/{company_id}/subscriptions"
tags: ["subscriptions"]
---

# List Company Subscriptions

`GET /companies/{company_id}/subscriptions`

The SUBSCRIBERS panel: rows plus the four head counts.

Rows include the owner's own ``mode='test'`` subscriptions flagged ``test``
(D43) and canceled rows for 90 days after they ended; the counts are live
rows only, so a test subscription never moves a number the owner reads.

## Path parameters

- `company_id` string, uuid, required

## Query parameters

- `status` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- CompanySubscriptionListResponse — The panel envelope, shaped like ``list_app_users``' (spec section 4.2).
  - `rows` CompanySubscriptionResponse[], required
    - `id` string, required
    - `user` SubscriberUserResponse, required — The buyer's NanoCorp account, as the row renders it.
      - `name` string, nullable
      - `email` string, nullable
      - `picture` string, nullable
    - `product_id` string, required
    - `plan_name` string, nullable
    - `status` string, required
    - `cancel_at_period_end` boolean
    - `cancel_at` string, date-time, nullable
    - `current_period_end` string, date-time, nullable
    - `next_payment_attempt` string, date-time, nullable
    - `since` string, date-time, required
    - `price_cents` integer, nullable
    - `currency` string, nullable
    - `test` boolean
    - `canceled_by` string, nullable
    - `ended_at` string, date-time, nullable
  - `total` integer, required
  - `active` integer, required
  - `past_due` integer, required
  - `leaving` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-17** `fdb61f8c4234` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/subscriptions/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)