---
title: "Get a subscription by ID"
method: GET
path: "/companies/{companyId}/subscriptions/{id}"
tags: ["Subscriptions"]
---

# Get a subscription by ID

`GET /companies/{companyId}/subscriptions/{id}`

## Request

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

## Response `200`

Subscription found

- SubscriptionResponse
  - `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

## Other responses

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

---

[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)