---
title: "Programmatic Access to Fortanix Key Insight APIs"
slug: "programmatic-access-to-fortanix-key-insight-apis"
updated: 2026-05-26T11:26:08Z
published: 2026-05-26T11:26:08Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.fortanix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Programmatic Access to Fortanix Key Insight APIs

## 1.0 Introduction

This guide provides examples and use cases for using Fortanix Key Insight APIs to automate key discovery, risk assessment, and compliance operations.

## 2.0 Prerequisites

Before using the Fortanix Key Insight APIs, ensure that you have obtained an **access token** as described in the [*Programmatic Access to Fortanix Armor IAM*](https://support.fortanix.com/docs/programmatic-access-to-fortanix-armor-iam)*.*

## 3.0 Example - Retrieve an AWS Assessment Report

After obtaining the access token, you can use it to make authorized REST API requests.

For example, to retrieve an AWS assessment report from Fortanix Key Insight, use the following REST API request:

```bash
curl -X GET \'https://api.armor.fortanix.com/api/v1/discovery/{region}/scans/{scan_id}/assessment_report/aws' \
  -H 'X-Csrf-Header;' \
  -H "Authorization: Bearer ${access_token}"
```

Here,

- Replace `{region}` with the appropriate region. For example, `eu` or `na`.
- Replace `{scan_id}` with the relevant scan identifier. To obtain the Scan ID, use one of the following methods:
  - **REST API:** Get the Scan ID from the `/api/v1/discovery/scans` API response (`scan_id` field).
  - **User interface (UI):**
    1. Navigate to the Fortanix Key Insight **Overview** page.
    2. Select the required connection. For example, AWS connection.
    3. Open the **Developer Tools → Network** and locate the request for **scans?filter.**
    4. On the **Response** tab, retrieve the `scan_id` from the JSON response.

![A screenshot of a computer  AI-generated content may be incorrect.](https://cdn.us.document360.io/c3bd85d2-4ad8-4d85-9f60-f1c168a3aad9/Images/Documentation/programmatic-access-to-fortanix-key-insight-apis-image-db6db119.png)

**Figure 1: Obtain a Scan ID**
- Replace `access_token` with the access token you obtained earlier.

## 4.0 Additional Use Cases

In addition to retrieving assessment reports, the Fortanix Key Insight REST APIs can be used to automate broader discovery and assessment operations, including:

- Retrieving all configured connection details.
- Retrieving all created policies and their details.
- Retrieving all configured authentication details.
- Retrieving information for each scan of a specific connection.
- Retrieving detailed information for each connection, including:
  - Discovery information for all assets, including keys, resources, cryptographic assets, and certificates.
  - Overview and assessment reports.
  - Post Quantum Cryptography (PQC) readiness details.

## 5.0 Fortanix Key Insight REST APIs

*For detailed information on Fortanix Armor and Fortanix Key Insight REST APIs, refer to the*[*Fortanix Armor API*](https://support.fortanix.com/apidocs/introduction-4)*documentation.*

Fortanix Key Insight identifies encryption keys and data services across on-premises and hybrid multicloud environments, providing a unified dashboard for tracking key mappings and cryptographic security. It offers security and compliance teams data-driven insights to assess risks, align with best practices, and meet industry regulations. Iy also supports continuous risk mitigation and crypto-agility, adapting to evolving security needs, including preparation for the post-quantum era.