> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reducto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# License checks

The package checks your license with Reducto. Reducto does not bill for checks. Two rules apply: one before the first document opens, and one after that.

## Before the first document opens

A copy opens its first document only after Reducto answers that the license is good **and** that the Reducto API key belongs to the license's organization. Opening a document (`WordDocument.open`, or a drop or file pick in the editor) waits up to 10 seconds for that answer. Without it, the open fails with `ReductoLicenseError` (`unconfigured`): "Your package isn't configured properly." This happens when:

* The copy has no license: it was not installed with a Studio install token, and the server sets no `REDUCTO_LICENSE`.
* `REDUCTO_API_KEY` is not set on the server or the license proxy, or the key is from a different organization.
* The package cannot reach Reducto. See [Firewalls](https://docs.reducto.ai/office/licensing/setup.md#firewalls-and-networks-with-no-internet-access).

A browser editor with no license proxy opens no document either: it fails with `unproxied`. See [Set up](https://docs.reducto.ai/office/licensing/setup.md#3-in-a-browser-add-the-license-proxy).

There is no offline start. The first open always needs a good answer.

## After the first good check

The package checks again about every hour, in the background. Document calls do not wait for these checks. Each good check keeps the package working for 65 minutes.

If a check gets no answer (offline, timeout, server error), the package keeps working until 65 minutes after the last good check. After that, each call on an open document throws `ReductoLicenseError` (`unverified`), and opening a document waits up to 10 seconds for a good answer, then fails with `unconfigured`. The package keeps trying, and it works again after the next good check. A document that is already open stops at its next call.

## What an answer does

| Answer | What the package does |
| - | - |
| Your license is good, and the API key belongs to its organization | Works |
| Your license is good, but there is no API key or it belongs to a different organization | Opens no document (`unconfigured`) |
| Reducto revoked your license | Each call throws `revoked` |
| Your organization is out of Reducto credits, or payment is required | Each call throws `unpaid` at once. The package works again after the next check once credits are added |
| Reducto does not know the license | Each call throws `unknown` |
| No answer | Before the first open: `unconfigured`. After a good check: works until 65 minutes after it. Then calls throw `unverified`, and new opens fail with `unconfigured` |

## Usage reports

When a document starts a new [Session](https://docs.reducto.ai/office/licensing/sessions.md), the package reports it to Reducto. If Reducto answers checks but does not confirm the report within 30 seconds, each call throws `undelivered` until a check confirms it. A short outage does not cause this: while no check gets an answer, the report waits.

## Signed answers

Reducto signs each license answer. A proxy or another system on the network cannot change an answer or send an old one again.

## Revoke a token or a license

| What is revoked | Who does it | Result |
| - | - | - |
| An install token | You, in Studio | `npm install` with that token fails. Copies that you installed before continue to work |
| Your organization's license | Reducto | All your install tokens stop working. Each installed copy throws `ReductoLicenseError` (`revoked`) at its next check, in less than about one hour |

For retry timing, request bodies and the limits on queued reports, see [Check protocol](https://docs.reducto.ai/office/licensing/protocol.md).
