Capabilities
The capabilities service provides operations to determine what an organization or an environment is capable of doing within PingOne with respect to:
-
The organization’s current PingOne license.
-
The current utilization of PingOne resources.
-
The current PingOne system limits.
-
The products and services included in the environment’s bill of materials.
The Capabilities service is closely associated with the Licenses and Bill of Materials (BOM) services. The PingOne license and BOM identify the Ping Identity products associated with your organization and environment, but these services do not enumerate the specific actions you can perform. You can use the capabilities service to check the capabilities provided by the current license and the environment’s BOM. For example, if the organization-level capability canCreateEnvironment is set to true, it shows that the license grants you the capability to create new environments. Likewise, there can be numerous capabilities at the environment level, depending on the products in the BOM. The following list shows some of the actions that you might be able to perform:
"canUseCredentials": false,
"canUseCredentialsPushNotifications": false,
"canUseCustomSchema": true,
"canUseDaVinciAdminPortal": true,
In this case, you can implement a custom user schema and you can access the DaVinci admin portal, but you cannot perform actions that use credentials or credential-based push notifications.
Capabilities events generated
Refer to Audit Reporting Events for the events generated.
Assigning admin roles and permissions to this service
Admin role assignments determine access to PingOne APIs. When assigning admin roles to this service, refer to PingOne Permissions by Service for the service-specific permissions.
You can also choose to assign admin roles based on particular service resources. Refer to PingOne Permissions by Resource when assigning admin roles per service resources.
Admin assignments to roles are set by:
Refer to Roles Management for more information.
Organization capabilities data model
| Property | Type | Required | Mutable | Description |
|---|---|---|---|---|
|
Boolean |
N/A |
Read-only |
Whether the license allows production environments. |
|
Date |
N/A |
Read-only |
When the license period starts. |
|
Date |
N/A |
Read-only |
When the license period ends. |
|
String |
N/A |
Read-only |
The license ID for a license that can be assigned to the organization. |
|
Boolean |
N/A |
Read-only |
Whether the license is a trial license. |
|
String |
N/A |
Read-only |
The name of a license that can be assigned to the organization. |
|
String |
N/A |
Read-only |
The package type of a license that can be assigned to the organization. |
|
String[] |
N/A |
Read-only |
The names of the PingOne product types for a license that can be assigned to the organization. Can be: |
|
String[] |
N/A |
Read-only |
The names of the supported geographies for a license that can be assigned to the organization. |
|
Boolean |
N/A |
Read-only |
Whether the organization can contact PingOne support. |
|
Boolean |
N/A |
Read-only |
Whether the organization can create an environment. A return value of |
|
Boolean |
N/A |
Read-only |
Whether the organization can create short-term trial licenses. |
|
Boolean |
N/A |
Read-only |
The status of the associated license. Return values are |
|
String |
N/A |
Read-only |
The ID of the organization. |
Environment capabilities data model
| Property | Type | Required | Mutable | Description |
|---|---|---|---|---|
|
Boolean |
N/A |
Read-only |
Whether the license supports creation of resources in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports creation of custom roles in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports role assignments in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license allows contact of PingOne Support. |
|
Boolean |
N/A |
Read-only |
Whether the license supports creation of a application connections in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports creation of a custom domain in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the environment’s |
|
Boolean |
N/A |
Read-only |
Whether the license supports sending notifications outside of the environment’s whitelist. |
|
Boolean |
N/A |
Read-only |
Whether the license supports sending password management notifications. |
|
Boolean |
N/A |
Read-only |
Whether the license supports sending verification flow notifications. |
|
Boolean |
N/A |
Read-only |
Whether the license supports verification using unique identification number issued to residents of India by the Unique Identification Authority of India (UIDAI). |
|
Boolean |
N/A |
Read-only |
Whether the license supports using additional verification support with American Association of Motor Vehicle Administrators (AAMVA). |
|
Boolean |
N/A |
Read-only |
Not implemented. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using account protection. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using account takeover detection. |
|
Boolean |
N/A |
Read-only |
Whether the license supports SSO advanced features, such as accepting third-party tokens for Token Exchange and provisioning of applications or AI agents via Client ID Metadata Document. |
|
Boolean |
N/A |
Read-only |
Whether a PingOne environment is licensed and enabled for advanced Security Token Service (STS) features, specifically including using PingOne as the federated STS to Entra ID for hybrid join and other WS-Trust 1.3 RST-based scenarios. |
|
Boolean |
N/A |
Read-only |
Whether a given environment is actually licensed to create and run AI agents (“Agentic” features). |
|
Boolean |
N/A |
Read-only |
Whether the license supports using API Access Management services. |
|
Boolean |
N/A |
Read-only |
Whether the PingOne Authorize Application permissions feature is licensed and enabled for that environment |
|
Boolean |
N/A |
Read-only |
Not implemented. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using malicious BOT device detection capabilities. |
|
Boolean |
N/A |
Read-only |
Not implemented. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using credentials services. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using credential sharing detection capabilities. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using credentials push notifications services. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using custom schema tributes in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using data analytics support services. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using data-based identity verification from TransUnion for the U.S. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using data-based identity verification from DataZoo for countries in Group 1. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using data-based identity verification from DataZoo for countries in Group 2. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using data-based identity verification from DataZoo for countries in Group 3. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using data-based identity verification from DataZoo for countries in Group 4. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using data-based identity verification from DataZoo for countries in Group 5. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using the DaVinci admin portal. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using verification through device ownership. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using digital verifications services. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using document match services. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using dynamic authorization services. |
|
Boolean |
N/A |
Read-only |
Whether admins are allowed to edit email notification templates in that environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using email OTP capabilities. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using face match capabilities. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using fraud data enrichment capabilities. |
|
Boolean |
N/A |
Read-only |
Not implemented. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using identities. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using external identity providers in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using inbound provisioning services. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using PingIntellegence capabilities in the specified environment. This capability applies to the PingOne Platform and PingOne MFA products. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using PingIntellegence advanced predictors capabilities in the specified environment. This capability applies to the PingOne Platform and PingOne MFA products. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using PingIntellegence anonymous network detection capabilities in the specified environment. This capability applies to the PingOne Platform and PingOne MFA products. |
|
Boolean |
N/A |
Mutable |
Whether the customer consents to user and event behavior analytics (UEBA) collection capabilities in the specified environment. This capability applies to the PingOne Protect product. |
|
Boolean |
N/A |
Mutable |
Whether the license supports editing PingIntellegence policy scores in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using PingIntellegence geovelocity capabilities in the specified environment when a geovelocity anomaly is detected. This capability applies to the PingOne Protect and PingOne MFA products. |
|
Boolean |
N/A |
Read-only |
Whether a PingOne environment is allowed to use the PingIntellegence “Last transaction older than …”, a time-since-last-transaction condition, in risk policy evaluation. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using a PingIntellegence composite risk predictor limited to combining IP and country as the additional risk factors. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using PingIntellegence New Device–type predictors in a Protect policy. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using protect capabilities in the specified environment. This capability applies to the PingOne Protect product. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using PingIntellegence reputation capabilities in the specified environment. This capability applies to the PingOne Platform and PingOne MFA products. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using Risk capabilities in the specified environment. This capability applies to the PingOne Protect product. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using PingIntellegence Trusted Device predictors in a Protect policy. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using Kerberos gateway services. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using LDAP gateway services. |
|
Boolean |
N/A |
Read-only |
Not implemented. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using manual document ID inspection services. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using manual document ID step-up inspection services. |
|
Boolean |
N/A |
Read-only |
Not implemented. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using MFA in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the environment is licensed to use PingOne MFA for consumer identity access management (CIAM). |
|
Boolean |
N/A |
Read-only |
Whether the license supports MFA operations on FIDO2 devices. |
|
Boolean |
N/A |
Read-only |
Whether the license supports MFA push authentication for native applications in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the environment is licensed to create and use MFA-specific sign-on policies. |
|
Boolean |
N/A |
Read-only |
Whether the license supports MFA voice OTP for native applications in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the environment is licensed to use PingOne MFA for workforce. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using the My Account capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using new account fraud detection capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether a PingOne environment is licensed to use OATH-compliant tokens as MFA authenticators. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using orchestration capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using password management capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using password only login capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using password policies in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the environment is licensed to use the PingID mobile app as a mobile MFA method. |
|
Boolean |
N/A |
Read-only |
Whether the environment is licensed to use the legacy PingID desktop app as an MFA method. |
|
Boolean |
N/A |
Read-only |
Whether the environment is licensed to use the generation 2 PingID desktop app as an MFA method. |
|
Boolean |
N/A |
Read-only |
Whether a PingOne tenant is allowed to use the Ping-managed SMS/voice provider for notifications instead of a customer’s own telephony provider. |
|
Boolean |
N/A |
Read-only |
The status of the associated license. Return values are |
|
Boolean |
N/A |
Read-only |
Whether the environment’s license is licensed to use PingOne Privilege. |
|
Boolean |
N/A |
Read-only |
Whether the environment’s license is licensed to use PingOne Privilege for cloud resources. |
|
Boolean |
N/A |
Read-only |
Whether the environment’s license is licensed to use PingOne Privilege for on-premise resources. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using protect transaction capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using provisioning capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using radius gateway services. |
|
Boolean |
N/A |
Read-only |
Whether the environment’s license is licensed to use PingOne Recognize. |
|
Boolean |
N/A |
Read-only |
Whether the license supports allowing users to update their own profile. |
|
Boolean |
N/A |
Read-only |
Whether the license supports creating and running DaVinci scheduled flows and batch-processing subflows. |
|
Boolean |
N/A |
Read-only |
Whether a PingOne environment is licensed to use its own dedicated Amazon Simple Email Service (SES) tenant for notifications, instead of only using the shared SES tenant. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using SMS OTP capabilities. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using TOTP capabilities. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using universal capture capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using universal ID, a persistent device identifier for trusted devices. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using verification flows in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using Verify in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using verify push notifictions capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using verify voice capabilities in the specified environment. |
|
Boolean |
N/A |
Read-only |
Whether the license supports using WhatsApp as a one-time password (OTP) delivery channel. |
|
Boolean |
N/A |
Read-only |
Whether a PingOne environment is licensed to use the PingID Windows Login (Windows desktop/server login) MFA method. |
|
Boolean |
N/A |
Read-only |
Whether a PingOne environment is licensed to use YubiKey as an MFA factor. |
|
String |
N/A |
Read-only |
The ID of the environment. |
|
Integer |
N/A |
Read-only |
How many Aadhaar-based verification transactions are included in that license. |
|
Integer |
N/A |
Read-only |
Not implemented. |
|
Integer |
N/A |
Read-only |
How many AI agents are included in that license. |
|
Integer |
N/A |
Read-only |
How many DataZoo data-based identity verification transactions from Group 1 are included in that license. |
|
Integer |
N/A |
Read-only |
How many DataZoo data-based identity verification transactions from Group 2 are included in that license. |
|
Integer |
N/A |
Read-only |
How many DataZoo data-based identity verification transactions from Group 3 are included in that license. |
|
Integer |
N/A |
Read-only |
How many DataZoo data-based identity verification transactions from Group 4 are included in that license. |
|
Integer |
N/A |
Read-only |
How many DataZoo data-based identity verification transactions from Group 5 are included in that license. |
|
Integer |
N/A |
Read-only |
How many TransUnion data-based identity verification transactions are included in that license. |
|
Integer |
N/A |
Read-only |
How many device ownership verification transactions. |
|
Integer |
N/A |
Read-only |
Not implemented. |
|
Integer |
N/A |
Read-only |
How many Not implemented. |
|
Integer |
N/A |
Read-only |
How many PingOne Privilege cloud resources are included in that license. |
|
Integer |
N/A |
Read-only |
How many PingOne Privilege on-premise resources are included in that license. |
Capabilities errors
In addition to the general error codes, capabilities operations can return the following errors:
| HTTP status | Top‑level code | Detail code | When it happens and what the response contains |
|---|---|---|---|
400 |
|
|
Message: When and detailsWhen: A Details: |
403 |
|
|
Message: When and detailsWhen: The actor is not entitled to the requested environment or organization, for example when the environment does not belong to the actor’s organization Details: |
403 |
|
None |
Message: When and detailsWhen: The actor lacks the Details: None. |
404 |
|
None |
Message: When and detailsWhen: The environment or organization in the request path does not exist Details: None. |
You need Organization Admin role or the Environment Admin role to get the capabilities for an organization or an environment, respectively. For more information about roles, refer to Roles.