---
title: "Read this organization's current license key"
method: GET
path: "/api/v1/licenses/keys/current"
tags: ["internal"]
---

# Read this organization's current license key

`GET /api/v1/licenses/keys/current`

## Request

- Base URL: `https://app.scanopy.net`
- URL: `https://app.scanopy.net/api/v1/licenses/keys/current`
- Auth: one of:
  - API key in header `Authorization`
  - API key in cookie `session_id`

Returns whichever key type the organization has issued, minted from its
current state. Online keys are deterministic, so this returns the same
string every time until the key is regenerated or the type is switched.

## Response `200`

The organization's current license key

- ApiResponseLicenseKeyResponse: Envelope for a successful response. Failures are sent with a non-2xx status and an `ApiErrorResponse` body instead.
  - `data` object: The result payload. Omitted on failure.
    - `key` string, required: Signed key to set as `SCANOPY_LICENSE_KEY` on a self-hosted server.
    - `key_type` 'Online' | 'Offline', required: The two keys an org owner can copy for a self-hosted server. An organization has one of these issued at a time, stored on the org row. Serde keeps the API spelling (`"Online"` / `"Offline"`); strum supplies the snake_case text the column is stored as, the way `PlanStatus` does.
  - `error` string, nullable: Not sent on a successful response. Failure messages arrive in an `ApiErrorResponse`.
  - `meta` ApiMeta, required: API metadata included in all responses
    - `api_version` integer, required: API version (integer, increments on breaking changes)
    - `server_version` string, required: Server version (semver)
  - `success` boolean, required: Always `true` on a successful response.

## Other responses

- `403`: Not an owner, or the plan has no license key

## Changes

- **2026-10-26** `c9d9d46d1ae8`: 1 info
  - api tag `billing` removed
- **2026-09-24** `aa9c34a755ae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scanopy/apis/scanopy-api/changes/api/v1/licenses/keys/current/get.md)

---

[API](https://skmtc.dev/scanopy/apis/scanopy-api.md) - [All operations](https://skmtc.dev/scanopy/apis/scanopy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scanopy/apis/scanopy-api/revisions/966ba786bdb5?raw)