---
title: "Start Trial"
method: POST
path: "/api/v1/trial/start"
tags: ["licenses"]
---

# Start Trial

`POST /api/v1/trial/start`

## Request

- Base URL: `https://api.actvt.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.actvt.io/api/v1/trial/start`
- Auth: none declared

Mint (or recover) the one-time, server-granted 7-day trial for a machine.

## Request body

- TrialStartRequest
  - `machine_fingerprint` object, required
  - `install_id` string, uuid, nullable

## Response `200`

Successful Response

- TrialStartResponse
  - `license_key` string, required
  - `activation_id` string, uuid, required
  - `expires_at` string, date-time, required
  - `features` string[]
  - `status` string
  - `tier` string
  - `entitlement` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/actvt/apis/actvt-licensing-api.md) · [All operations](https://skmtc.dev/actvt/apis/actvt-licensing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/actvt/apis/actvt-licensing-api/revisions/f8d53e5bb638?raw)