---
title: "Retrieve a co-term group"
method: GET
path: "/subscriptions/coterm/{cotermGroupId}"
tags: ["Subscriptions"]
---

# Retrieve a co-term group

`GET /subscriptions/coterm/{cotermGroupId}`

Retrieves details for a specific co-term group using its ID.

## Path parameters

- `cotermGroupId` string, required

## Response `200`

OK

- CoTermDetailResponse — Flattened response structure used when retrieving group details via GET.
  - `action` string — The action performed.
  - `result` string — The result of the operation.
  - `coTermGroupId` string — Unique identifier for the co-term group.
  - `displayName` string — Display name of the group.
  - `account` string — Account ID associated with the group.
  - `initialOrder` string — The ID of the order that initiated the group.
  - `nextPeriodDate` integer — Timestamp of the next billing period start.
  - `nextPeriodDateDisplay` string — Human-readable display of the next billing date.
  - `nextPeriodDateDisplayISO8601` string — ISO8601 formatted string of the next billing date.
  - `groupingCriteria` GroupingCriteria — The criteria used to group subscriptions (currency, interval, etc).
    - `interval` object[] — Allowed billing intervals.
      - `unit` string — The interval unit.
      - `length` integer — The interval length.
    - `currency` string[] — Allowed currencies.
    - `paymentMethods` object[] — Allowed payment methods.
      - `type` string — Payment method type.
      - `ending` string — Display string for the payment method.
  - `subscriptions` SubscriptionDetail[] — List of subscriptions currently in the group.
    - `subscription` string — The subscription ID.
    - `baseSubscriptionProduct` string — The product path associated with the subscription.
    - `baseSubscriptionProductDisplay` string — The display name of the product.
    - `periodStartDate` integer — Timestamp of the current period start.
    - `periodStartDateDisplay` string — Human-readable display of the start date.
    - `periodStartDateDisplayISO8601` string — ISO8601 formatted start date.
    - `nextPeriodDate` integer — Timestamp of the next billing date.
    - `nextPeriodDateDisplay` string — Human-readable display of the next billing date.
    - `nextPeriodDateDisplayISO8601` string — ISO8601 formatted next billing date.
    - `coTermStatus` string — Current status of the subscription relative to co-terming.
    - `renewalAmount` string — The formatted renewal amount.

---

[API](https://skmtc.net/fastspring/apis/fastspring-api-accounts.md) · [All operations](https://skmtc.net/fastspring/apis/fastspring-api-accounts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fastspring/fastspring-api-accounts/versions/ae2f0b97db3e/schema)