---
title: "List subscriptions for a company"
method: GET
path: "/companies/{companyId}/subscriptions"
tags: ["Subscriptions"]
---

# List subscriptions for a company

`GET /companies/{companyId}/subscriptions`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/subscriptions`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `status` string
- `category` string

## Response `200`

Paginated list of subscriptions

- SubscriptionsListResponse
  - `success` boolean
  - `data` Subscription[]
    - `id` string, uuid, required
    - `companyId` string, uuid, required
    - `name` string, required
    - `vendor` string, required
    - `category` string, required
    - `amountCents` integer, required
    - `currency` string, required: Explicit supported scale-two ISO 4217 currency authority.
    - `minorUnitExponent` 2, required
    - `billingFrequency` 'monthly' | 'annual', required: Coarse cadence used by the legacy manual-CRUD path. For the detector-populated cadence, prefer `interval`.
    - `nextChargeOn` string, date, nullable
    - `status` string, required
    - `createdAt` string, date-time
    - `merchantName` string, nullable
    - `interval` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'annual': Detected (or manually set) billing cadence. The detector only writes one of these five values when confidence >= 80%; otherwise the row is not persisted as a subscription.
    - `firstSeenAt` string, date-time, nullable
    - `lastSeenAt` string, date-time, nullable
    - `nextExpectedAt` string, date-time, nullable
    - `transactionCount` integer, required
    - `totalSpentCents` integer, required
    - `detectionSource` 'auto' | 'manual', required
    - `updatedAt` string, date-time
  - `meta` PaginationMeta
    - `nextCursor` string, nullable
    - `hasMore` boolean

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)