Skip to content
MCP Gateway

Read safe license and entitlement status for one environment.

GET
/v1/license

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
environment_id
required
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

License status, entitlements, limits, usage, verification, and safe metadata.

object
schemaVersion
required
requestId
required
string
>= 1 characters
environmentId
required
string
>= 1 characters
generatedAt
required
string format: date-time
status
required
string
Allowed values: valid expired missing offline_grace
edition
required
Allowed values: enterprise
plan
required
Allowed values: self_hosted_enterprise hybrid_enterprise enterprise_trial
expiresAt
string format: date-time
renewalDueAt
string format: date-time
limits
required
Array<object>
object
key
required
Allowed values: seats api_operations data_planes connectors
limit
required
integer
unit
required
Allowed values: count
usage
required
Array<object>
object
key
required
Allowed values: seats api_operations data_planes connectors
current
required
integer
unit
required
Allowed values: count
features
required
Array<object>
object
key
required
Allowed values: api_to_mcp hybrid_control_plane offline_verification audit_export active_sessions
enabled
required
boolean
reasonCode
required
string
/^[a-z0-9_]+$/
verification
required
object
mode
required
Allowed values: online offline self_hosted
status
required
Allowed values: verified expired not_found grace not_checked
selfHosted
required
boolean
lastCheckedAt
required
string format: date-time
nextCheckDueAt
string format: date-time
graceEndsAt
string format: date-time
reasonCode
required
string
Allowed values: license_valid license_expired license_missing license_offline_grace license_permission_denied environment_mismatch
licenseMetadata
object
fingerprint
required
string
>= 1 characters
issuer
required
string
>= 1 characters
subject
required
string
>= 1 characters
issuedAt
required
string format: date-time
algorithm
required
Allowed values: ed25519 rsa_pss_sha256
validationResult
required
Allowed values: accepted expired missing offline_grace
rawMaterialReturned
required
boolean
reasonCode
required
string
Allowed values: license_valid license_expired license_missing license_offline_grace license_permission_denied environment_mismatch
permissions
required
object
allowedActions
required
Array
Allowed values: license.read license.view_entitlements
warnings
required
Array<string>

403

Section titled “403 ”

Caller is authenticated but not allowed to read license detail.

object
schemaVersion
required
requestId
required
string
>= 1 characters
status
required
integer
>= 400 <= 599
reasonCode
required
string
/^[a-z0-9_]+$/
message
required
string
>= 1 characters
retryable
required
boolean
machineSafe
required
boolean
redactionStatus
required
Allowed values: redacted metadata_only
field

Optional metadata-only field identifier for validation errors.

string
details

Optional metadata-only diagnostic details. Never include secret material, payloads, prompts, raw endpoint URLs, or customer data.

object
requiredAction
string
>= 1 characters
resourceRef
string
>= 1 characters
key
additional properties
One of:
string

Type set in Geist, Source Serif 4, and Departure Mono.