Handling Activations

Learn how license activations work.

What are Activations?

Activations track when a user validates their license. They are automatically created or updated when you call the validate endpoint.

Activation Properties:

  • activatedAt - When the license was first activated
  • lastCheckedAt - Last time the license was validated
  • Links a user to a license

How Activations Work

  1. When you validate a license, the system checks for an existing activation
  2. If no activation exists, one is created
  3. If an activation exists, lastCheckedAt is updated
  4. Activations are used to track seat usage for licenses with maxSeats

Viewing Activations

You can view activation information through the license usage endpoint:

GET /api/v1/admin/licenses/:id/usage

Response:
{
  "license": { ... },
  "activations": [ ... ],
  "totalActivations": 10,
  "activeSeats": 5
}