Skip to content

Retrieves an entitlement by its external-system reference (e.g. `stripe:subscription:sub_…`).

GET
/api/v1/provision/admin/entitlements/by-external-reference/{externalReference}
curl --request GET \
--url https://example.com/api/v1/provision/admin/entitlements/by-external-reference/example
externalReference
required
string

The scheme:type:id external anchor set by inbound connector provisioning.

OK

object
legalNoticeHtml
string
description
string
name
string
version
null | string
customerContactEmail
string
customerContactName
string
status
integer
subscriptionStatus

Consumer-facing subscription/lifecycle status, derived server-side from EntitlementLifecycleStatus EntitlementDto.Status, expiration dates, and trial / pause state.

integer
licenseKey
null | string
expirationDateTime
string format: date-time
isEntitlementTrial
boolean
id
string format: uuid
isTemplateForNewEntitlements
boolean
products
Array<object>
object
id
string format: uuid
status

Indicates the current product status in its lifecycle.

integer
providerId

Unique identifier of the provider associated with this product.

string format: uuid
name

Public-facing name of the product used for display purposes.

string
description

Description of the product as displayed in the customer portal.

string
productCode

Unique internal code of the product. Must be unique in combination with string ProductDto.ProductVersion.

string
productVersion

Version of the product visible to the end user, recommended in Semantic Versioning (SemVer) format, e.g., “Major.Minor.Patch”. Optional build information may follow a plus sign, e.g., “2.1.3+build.12345”.

string
expirationDate

Expiration date, after which the product is no longer available for deployment. Null if no expiration is set.

null | string format: date-time
externalId

Optional external identifier, such as a CMS or ERP ID.

null | string
productNamespace

Optional namespace used to group products logically.

null | string
features

Collection of features that define additional functionalities of the product.

Array<object>
object
id
string format: uuid
featureCatalogId
null | string format: uuid
featureCode
string
featurePath
null | string
moduleName
null | string
name
string
description
null | string
usageMetric
null | string
units
null | string
featureType
integer
enumOptions
Array<object>
object
value
string
description
null | string
value
null | string
version
null | string
isEnabled
boolean
includeInLicenseToken
boolean
isAvailableDuringTrialPeriod
boolean
isAvailableDuringGracePeriod
boolean
canModifyValueOnEntitlement
boolean
meterAggregationType
One of:
null
visibility
integer
isDeleted
boolean
creationTimeStamp
string format: date-time
lastUpdateTimeStamp
null | string format: date-time
revisionNumber
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
monitoredAssets

Assets associated with the product for usage monitoring.

Array<object>
object
id
string format: uuid
entitlementId
null | string format: uuid
productId
null | string format: uuid
metricName
string
name
string
description
string
unit
string
category
string
tags
Array<string>
numberFormat
string
metricType
integer
meteredUsageId
null | string format: uuid
meteredUsage
One of:
null
balanceUsageId
null | string format: uuid
balanceUsage
One of:
null
allowedBackDatingTolerance
string
/^-?(\d+\.)?\d{2}:\d{2}:\d{2}(\.\d{1,7})?$/
metrics

Lightweight metric definitions for this product.

Array<object>
object
id
string format: uuid
productId
string format: uuid
metricName
string
name
string
description
null | string
metricType
integer
unit
string
category
string
numberFormat
string
productInformation

Additional product information, including URLs and revision details.

object
displayVersion
null | string
additionalInformation
null | string
revisionInformation
null | string
downloadUrl
null | string
informationUrl
null | string
supportUrl
null | string
propertyValues

Custom properties for storing additional information associated with the product.

object
key
additional properties
object
key
string
value
string
metadata
Array<object> | null
object
key
string
value
string
isDeleted
boolean
createdAt
string format: date-time
updatedAt
null | string format: date-time
revisionNumber
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
isLocked

Indicates if the product is locked for editing. Locked products cannot be modified.

boolean
productMetaData

Additional metadata about the product stored as a JSON string. May include technical specifications, system requirements, or custom attributes.

null | string
applicationScopes

List of application scopes that are authorized to use this product. Application scopes define which application types or deployment targets can activate this product. If null or empty, any application can use this product (no scope restrictions).

Array<string> | null
parentProductId

Parent product ID if this product belongs to an inherited version lineage.

null | string format: uuid
features
Array<object>
object
id
string format: uuid
featureCode
string
productId
string format: uuid
moduleName
string
featurePath
string
name
string
description
string
value
null | string
version
string
isEnabled
boolean
isAvailableDuringTrialPeriod
boolean
isAvailableDuringGracePeriod
boolean
canModifyValueOnEntitlement
boolean
meteredAssetId
string format: uuid
featureExpiration
null | string format: date-time
createdAt
string format: date-time
updatedAt
string format: date-time
customerId
string format: uuid
activationPolicy
One of:
null
claimBasedActivation
One of:
null
timeRestrictedActivationPolicy
One of:
null
trialActivationPolicy
One of:
null
subscriptionPolicy
One of:
null
orderId
string
reference
string
externalReference

External anchor of the originating subscription/grant (e.g. stripe:subscription:sub_…).

string
customerExternalReference

External anchor of the owning customer/account (e.g. stripe:customer:cus_…).

string
metadata

Opaque connector provenance / pass-through (mirrors Stripe metadata).

object
key
additional properties
string
assignedPlanSetId
null | string format: uuid
assignedPlanName
null | string
temporaryOverride
object
planSetId
null | string format: uuid
planName
null | string
validFromUtc
null | string format: date-time
validUntilUtc
null | string format: date-time
reason
null | string
previousPlanSetId
null | string format: uuid
previousPlanName
null | string
applicationScopes
Array<string>
effectiveApplicationScopes
Array<string>
planAssignmentHistory
Array<object>
object
changedAt
string format: date-time
previousPlanSetId
null | string format: uuid
previousPlanName
null | string
newPlanSetId
null | string format: uuid
newPlanName
null | string
source
string

Not Found

object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string