---
title: "Create or import a license request"
method: POST
path: "/requests"
tags: ["License Portal"]
---

# Create or import a license request

`POST /requests`

Creates a portal license request. For licensee-initiated issuance,
include the signed platform request artifact generated by the target
platform. The artifact is validated by the portal before it is used for
certificate and license issuance.

## Request body

- CreateLicenseRequestArgs
  - `requestId` string
  - `customerPartyId` string, required
  - `softwarePartyId` string, required
  - `templateId` string
  - `profileId` string
  - `product` string, required
  - `edition` string, required
  - `features` string[]
  - `quotas` LongMap
  - `gatePolicy` LicenseGatePolicy
    - `productFeatures` LicenseGateRules
      - `enabled` string[]
      - `disabled` string[]
    - `commands` LicenseGateRules
      - `enabled` string[]
      - `disabled` string[]
  - `validFrom` string
  - `expiresAt` string
  - `installationBaseDomain` string — Optional deployment base domain for direct issuer-created setup bundles. Omit to issue a domain-agnostic license.
  - `platformDomainRoots` string[] — Optional allowed platform domain roots for direct issuer-created setup bundles. Empty means any base domain.
  - `notes` string
  - `technicalContact` LicenseRequestContact
    - `email` string, email, required
    - `displayName` string, required
    - `role` string, required
  - `administratorContact` LicenseRequestContact
    - `email` string, email, required
    - `displayName` string, required
    - `role` string, required
  - `importedRequestArtifact` ImportedPlatformLicenseRequestArtifact
    - `requestJson` string, required — Signed license request JSON generated by the target platform.
    - `signature` ImportedPlatformLicenseRequestSignature
      - `algorithm` string
      - `keyId` string
      - `signatureBase64` string
    - `certificateSigningRequest` ImportedPlatformLicenseRequestCertificateSigningRequest
      - `pem` string
      - `derBase64` string
      - `fingerprint` string
    - `artifactDigest` string
    - `schemaVersion` string
    - `requestSigningKeyId` string
    - `requestSigningPublicKeyThumbprint` string
    - `installationBaseDomain` string
    - `platformIssuer` string
    - `platformDomainRoots` string[]
    - `validationStatus` 'unvalidated' | 'valid' | 'invalid'
    - `validationMessages` string[]

## Response `201`

Created license request.

- LicenseIssueRequest
  - `requestId` string, required
  - `customerPartyId` string, required
  - `softwarePartyId` string, required
  - `installationId` string, required
  - `templateId` string
  - `profileId` string
  - `product` string, required
  - `edition` string, required
  - `features` string[], required
  - `quotas` LongMap, required
  - `gatePolicy` LicenseGatePolicy
    - `productFeatures` LicenseGateRules
      - `enabled` string[]
      - `disabled` string[]
    - `commands` LicenseGateRules
      - `enabled` string[]
      - `disabled` string[]
  - `validFrom` string, required
  - `expiresAt` string, required
  - `installationBaseDomain` string — Optional deployment base domain for direct issuer-created setup bundles. Omit to issue a domain-agnostic license.
  - `platformDomainRoots` string[] — Optional allowed platform domain roots for direct issuer-created setup bundles. Empty means any base domain.
  - `notes` string
  - `technicalContact` LicenseRequestContact
    - `email` string, email, required
    - `displayName` string, required
    - `role` string, required
  - `administratorContact` LicenseRequestContact
    - `email` string, email, required
    - `displayName` string, required
    - `role` string, required
  - `contactIds` StringMap, required
  - `importedRequestArtifact` ImportedPlatformLicenseRequestArtifact
    - `requestJson` string, required — Signed license request JSON generated by the target platform.
    - `signature` ImportedPlatformLicenseRequestSignature
      - `algorithm` string
      - `keyId` string
      - `signatureBase64` string
    - `certificateSigningRequest` ImportedPlatformLicenseRequestCertificateSigningRequest
      - `pem` string
      - `derBase64` string
      - `fingerprint` string
    - `artifactDigest` string
    - `schemaVersion` string
    - `requestSigningKeyId` string
    - `requestSigningPublicKeyThumbprint` string
    - `installationBaseDomain` string
    - `platformIssuer` string
    - `platformDomainRoots` string[]
    - `validationStatus` 'unvalidated' | 'valid' | 'invalid'
    - `validationMessages` string[]
  - `status` string, required
  - `createdAt` string, required
  - `tenantId` string

---

[API](https://skmtc.net/sphereon-opensource/apis/license-portal-api.md) · [All operations](https://skmtc.net/sphereon-opensource/apis/license-portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sphereon-opensource/license-portal-api/versions/f45b2d91505a/schema)