References → Public API

Incorta’s public application programming interface (API) allows developers to interact with data within Incorta for programmatic uses. The power of being able to access data programmatically opens the door to many new uses of the application. Incorta receives API endpoint request payloads and returns response payloads in JSON.

Notes
  • For releases before v8.0.0 - 2026.8, use the HTTPS or HTTP scheme according to your installation. You must use the HTTPS scheme to successfully run the API endpoints on Cloud installations.
  • You must specify the tenant name (case-sensitive) in the endpoint request URL.

There are two versions of Incorta public API: Public API v1 and Public API v2. Public API v1 is available in all releases starting with 5.0 while Public API v2 is available starting the 6.0 On-Premisses release and the 2023.4.0 Cloud release. The 6.0 and 2023.4.0 releases introduced a new authentication process that Public API v1 isn't compatible with. Thus, you can't use any release starting the 6.0 On-Premisses release and the 2023.4.0 Cloud release to generate new API keys or renew existing ones that are used in Public API v1. However, you can refresh existing access tokens, or you can use the latest API key that you generated before upgrading to these releases and use it to create new access tokens for Public API v1 as usual.

For details, refer to Public API v1 or Public API v2.