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.

The information shown can be searched, filtered, sorted, viewed, and downloaded.

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

Schema for Table: "OrganizationCotermLicenses"
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

Reconnection

Reconnection

Reconnection

timed out

timed out

Attempt of

Reload
An unhandled error has occurred. Reload 🗙