TransaktDocs
API referenceEntitlements

Check whether a user may use a product (by email)

POST
/api/v1/entitlements/{tenantId}/eligibility

As the GET form, with the question in the body: userObjectId or email. An email is resolved to the one active member of the organisation that holds the tenant; otherwise the answer is 422 entitlement.user_not_resolved and you should ask by object id.

Errors: request.validation_failed, api_client.product_not_allowed, entitlement.user_tenant_mismatch, entitlement.user_not_resolved, product.not_found, plan.not_found, auth.credentials_invalid, auth.forbidden, request.rate_limited.

Authorization

headerAuthorizationBearer <token>

A Microsoft Entra client-credentials token for the Transakt API (scope api://{apiAppId}/.default), issued in the tenant recorded on the API client credential, with the app role matching the operation: Entitlement.Read.All, Catalogue.Read.All or Usage.Write.All.

Scope: api://{apiAppId}/.default

Path Parameters

tenantId*string
Formatuuid

Request Body

application/json
  1. body

EligibilityRequest (P-06): the email form keeps personal data out of URLs.

product*|
Length1 <= length <= 64
plan?|
Length1 <= length <= 64
userObjectId?|
Formatuuid
email?|
Length0 <= length <= 320

Response Body

OK

application/json
  1. response

UserEligibility (6.5.8).

tenantId*string
Formatuuid
product*
plan*null|
requestedPlan*null|string
subject*
tenantEntitled*boolean
licenceModel*null|
licenceOutcome*LicenceOutcome
Value in"Licensed""NotLicensed""Unconfirmed""ConsentRequired""NotApplicable"
isEligible*boolean
reason*EligibilityReason
Value in"TenantWideEntitlement""SeatAssigned""MicrosoftLicensed""TenantNotEntitled""PlanMismatch""NoSeatAssigned""MicrosoftNotLicensed""NoMicrosoftPlan""MicrosoftNoLicencesReported""MicrosoftUnavailable""MicrosoftNotConfigured""DelegatedConsentMissing"
seats*null|
microsoftLicence*null|
evaluatedAt*string
Formatdate-time
curl -X POST "https://example.com/api/v1/entitlements/497f6eca-6276-4993-bfeb-53cbbbba6f08/eligibility" \  -H "Content-Type: application/json" \  -d '{    "product": null  }'
{  "tenantId": "f97df110-f4de-492e-8849-4a6af68026b0",  "product": {    "slug": "string",    "name": "string"  },  "plan": null,  "requestedPlan": null,  "subject": {    "objectId": null,    "email": null,    "isCaller": true  },  "tenantEntitled": true,  "licenceModel": null,  "licenceOutcome": "Licensed",  "isEligible": true,  "reason": "TenantWideEntitlement",  "seats": null,  "microsoftLicence": null,  "evaluatedAt": "2019-08-24T14:15:22Z"}

API reference

The product API, generated from its OpenAPI document.

Get a tenant entitlement GET

What the tenant (a customer's Microsoft Entra tenant id) holds for one of your products: status, access level, edition, plans, licence model, feature capabilities, seat quantity and validity. Ask with `plan` for a plan-scoped answer. `status` is `None` when the tenant never bought the product. Scope `entitlements:read` (app role `Entitlement.Read.All`). Errors: [`api_client.product_not_allowed`](/errors/api_client.product_not_allowed/), [`entitlement.user_tenant_mismatch`](/errors/entitlement.user_tenant_mismatch/), [`product.not_found`](/errors/product.not_found/), [`plan.not_found`](/errors/plan.not_found/), [`auth.credentials_invalid`](/errors/auth.credentials_invalid/), [`auth.forbidden`](/errors/auth.forbidden/), [`request.rate_limited`](/errors/request.rate_limited/).