---
title: "POST /api/licenses/"
method: POST
path: "/api/licenses/"
tags: ["Admin"]
---

# POST /api/licenses/

`POST /api/licenses/`

Registers a new license. After registering you can assign users to the license that will be able to use the license's features while the license is active. If an existing license with the same `license_id` already exists and the provided license has been issued later than that one, the existing one will be upgraded.

## Request body

- RegisterLicense
  - `license` string, required — The license that you want to register.

## Response `200`

- License
  - `id` integer, required
  - `license_id` string, required — Unique identifier of the license.
  - `is_active` boolean, required — Indicates if the backend deems the license valid.
  - `last_check` string, date-time, nullable
  - `valid_from` string, date-time, required — From which timestamp the license becomes active.
  - `valid_through` string, date-time, required — Until which timestamp the license is active.
  - `free_users_count` integer, required — The amount of free users that are currently using the license.
  - `seats_taken` integer, required — The amount of users that are currently using the license.
  - `seats` integer, required — The maximum amount of users that can use the license.
  - `application_users_taken` integer, required — The amount of application builder users used so far in this license.
  - `application_users` integer, required — The amount of application builder users permitted in this license.
  - `product_code` string, required — The product code that indicates what the license unlocks.
  - `issued_on` string, date-time, required — The date when the license was issued. It could be that a new license is issued with the same `license_id` because it was updated. In that case, the one that has been issued last should be used.
  - `issued_to_email` string, email, required — Indicates to which email address the license has been issued.
  - `issued_to_name` string, required — Indicates to whom the license has been issued.

## Other responses

- `400`

---

[API](https://skmtc.net/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.net/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/versions/0c490e5b0c7f/schema)