Meraki DataMagic - CoTerm Licensing
Introduction
The Co-Term Licensing page shows details for Meraki co-termination (co-term) licences. Co-term licensing is a Meraki licensing model that aligns all device licences within an organisation to a single shared expiration date. When a new licence is claimed, its term is blended into the organisation's existing co-termination date rather than tracked individually per device.
Each co-term licence record represents a single licence claim event. It includes the licence key, duration in days, the mode of claim (adding devices or renewing), edition and product type information, and per-model device counts. The calculated expiration date is derived from the start date plus the duration.
Co-term licence data is fetched daily from the Meraki API endpoint /organizations/{organizationId}/licensing/coterm/licenses.
You can filter using the Estate Tree:
- Home: For all Meraki Organizations
- Organization: For one Meraki Organization
Further filtering can be done using the Table filters.
Table columns
The main table shows one row per co-term licence with the following columns:
- Organization — The Meraki organization that owns this licence. Hidden when the Estate Tree is scoped to a single organization.
- License Key — Unique Meraki licence key identifier (e.g. Z2AA-XXXX-XXXX), with a clipboard copy button.
- Mode — The operation mode when the licence was claimed: "addDevices" (adding new devices) or "renew" (extending the co-termination date).
- Duration (days) — The term length of the licence in days.
- Status — Derived status based on the licence state. Shown in green for active licences and red for expired or invalidated.
- Started — When the licence term began (approximately when the licence was created).
- Expiration — Calculated expiration date (start date + duration). Colour-coded: red if expired, amber if within 30 days, blue if within 90 days.
- Claimed — When the licence was claimed into the organization.
- Invalidated — Whether the licence has been invalidated. Shown in red if Yes.
- Editions — Licence editions and product types, formatted as "Edition (ProductType)" (e.g. Enterprise (appliance), Enterprise (wireless)).
- Counts — Device model counts showing model name and quantity per line (e.g. MX Enterprise: 5).
Co-Term Licence detail popup
Double-clicking a row opens a detail popup for the selected co-term licence. The popup contains:
Summary panels — Four panels across the top showing:
- Status — Active, Expired, or Invalidated, with the claim mode shown beneath.
- Duration — The licence term length in days.
- Started — When the licence term began.
- Expiration — The calculated expiration date, with a countdown showing days remaining or days since expiry.
Details section — Two-column layout showing:
- License Key, Meraki Organization ID, claimed date, and invalidated date if applicable (left column)
- Editions table showing edition name and product type for each licence edition (right column)
Copyable fields have a clipboard icon for quick copying.
Device Counts table — Lists the per-model device allocations within the licence:
- Model — The device model name (e.g. MX Enterprise, MR Advanced).
- Count — Number of devices of that model covered by this licence.
Table definition
| Name | Type | Description |
|---|---|---|
| Id | uuid | Unique identifier for the entity record |
| OrganizationId | uuid | Foreign key reference to the Organization this co-term licence belongs to |
| Key | character varying (64) | Unique Meraki co-term licence key identifier |
| MerakiOrganizationId | character varying (64) | The Meraki organization ID this licence is claimed in |
| Duration | integer | The duration (term length) of the licence in days |
| Mode | character varying (32) | The operation mode when the licence was claimed ('addDevices' or 'renew') |
| StartedAt | timestamp with time zone | When the licence term began (approximately when the licence was created) |
| ClaimedAt | timestamp with time zone | When the licence was claimed into the organization |
| Invalidated | boolean | Whether the licence has been invalidated |
| InvalidatedAt | timestamp with time zone | When the licence was invalidated (null for active licences) |
| Expired | boolean | Whether the licence has expired |
| ExpirationDate | timestamp with time zone | Calculated expiration date: StartedAt + Duration days |
| EditionsJson | character varying (2048) | Licence editions per product type (JSON array, e.g. [{"edition":"Enterprise","productType":"appliance"}]) |
| CountsJson | character varying (2048) | Licence counts per model type (JSON array, e.g. [{"model":"MR Enterprise","count":2}]) |
| Created | timestamp with time zone | Timestamp when the record was initially created in the system |
| LastModified | timestamp with time zone | Timestamp when the record was last modified or updated |