Armor

Armor CSPM Report API

CSPM report operations

GitHub OpenAPI

Operations 5

GET /cspm/report/list Get list of CSPM reports #
POST /cspm/report/run Run CSPM report configuration by ID #
GET /cspm/report/{id} Get CSPM report details by ID #
DELETE /cspm/report/{id} Delete CSPM report configuration by ID #
GET /cspm/report/{id}/control/{controlId}/resources Get report control resources by report and control ID #

Documentation

📖
Documentation
https://developer.armor.com/
📖
APIReference
https://developer.armor.com/swagger/security.fh-auth.yaml
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/armor/refs/heads/main/authentication/armor-authentication.yml
📖
APIReference
https://developer.armor.com/swagger/security.armor-psk.yaml
📖
APIReference
https://developer.armor.com/swagger/accounts-api.yaml
📖
APIReference
https://developer.armor.com/swagger/agent-management-api.yaml
📖
APIReference
https://developer.armor.com/swagger/compliance-api.yaml
📖
APIReference
https://developer.armor.com/swagger/container-security-api.yaml
📖
APIReference
https://developer.armor.com/swagger/incident-management-api.yaml
📖
APIReference
https://developer.armor.com/swagger/infrastructure-management-api.yaml
📖
APIReference
https://developer.armor.com/swagger/logs-api.yaml
📖
APIReference
https://developer.armor.com/swagger/notifications-api.yaml
📖
APIReference
https://developer.armor.com/swagger/webhooks-api.yaml
📖
APIReference
https://developer.armor.com/swagger/public-apis-all.yaml
📖
APIReference
https://developer.armor.com/swagger/v1/account-management/swagger.json
📖
APIReference
https://developer.armor.com/swagger/v1/infrastructure/swagger.json
📖
APIReference
https://developer.armor.com/swagger/v1/security/swagger.json
📖
APIReference
https://developer.armor.com/swagger/v1/support/swagger.json

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/armor/refs/heads/main/openapi/armor-cspm-report-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/armor/refs/heads/main/asyncapi/armor-webhooks-events.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/armor-cspm-report-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

armor-cspm-report-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Armor Compliance CSPM Report API
  description: 'Armor Compliance API provides endpoints for Cloud Security Posture Management (CSPM)

    and Vulnerability Scanning (VS) services.

    '
  version: 1.0.0
  contact:
    name: Armor Support
    url: https://www.armor.com/support
servers:
- url: https://compliance.api.secure-prod.services
  description: Production server
security:
- OAuth2: []
tags:
- name: CSPM Report
  description: CSPM report operations
paths:
  /cspm/report/list:
    get:
      tags:
      - CSPM Report
      summary: Get list of CSPM reports
      operationId: listCspmReports
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CspmReportListDto'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
  /cspm/report/run:
    post:
      tags:
      - CSPM Report
      summary: Run CSPM report configuration by ID
      operationId: runCspmReport
      parameters:
      - name: reportConfigId
        in: query
        required: true
        schema:
          type: string
        description: Report configuration ID
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Message'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /cspm/report/{id}:
    get:
      tags:
      - CSPM Report
      summary: Get CSPM report details by ID
      operationId: getCspmReportById
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Report ID
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CspmReportDetailsDto'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
    delete:
      tags:
      - CSPM Report
      summary: Delete CSPM report configuration by ID
      operationId: deleteCspmReport
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Report ID
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Message'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /cspm/report/{id}/control/{controlId}/resources:
    get:
      tags:
      - CSPM Report
      summary: Get report control resources by report and control ID
      operationId: getCspmReportControlResources
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Report ID
      - name: controlId
        in: path
        required: true
        schema:
          type: string
        description: Control ID
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CspmResourceDetails'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
components:
  schemas:
    CspmReportListDto:
      type: object
      properties:
        reportId:
          type: string
          description: Report ID
        title:
          type: string
          description: Report title
        cloudType:
          type: string
          description: Cloud type
        reportType:
          type: string
          description: Report type
        lastRunDate:
          type: string
          format: date-time
          description: Last run date
    CspmResourceDetails:
      type: object
      properties:
        resourceId:
          type: string
          description: Resource ID
        resourceName:
          type: string
          description: Resource name
        resourceType:
          type: string
          description: Resource type
        region:
          type: string
          description: Region
        status:
          type: string
          description: Status
    CspmReportRequirementDetails:
      type: object
      properties:
        requirementId:
          type: string
          description: Requirement ID
        requirementName:
          type: string
          description: Requirement name
        passCount:
          type: integer
          description: Pass count
        failCount:
          type: integer
          description: Fail count
    Message:
      type: object
      properties:
        message:
          type: string
          description: Response message
    CspmReportDetailsDto:
      type: object
      properties:
        title:
          type: string
          description: Report title
        reportId:
          type: string
          description: Report ID
        accountId:
          type: integer
          description: Account ID
        mandatesCount:
          type: integer
          description: Mandates count
        requirementsCount:
          type: integer
          description: Requirements count
        controlsCount:
          type: integer
          description: Controls count
        totalEvaluationsCount:
          type: integer
          description: Total evaluations count
        policiesCount:
          type: integer
          description: Policies count
        passCount:
          type: integer
          description: Pass count
        failCount:
          type: integer
          description: Fail count
        passPercent:
          type: number
          format: float
          description: Pass percentage
        failPercent:
          type: number
          format: float
          description: Fail percentage
        cloudType:
          type: string
          description: Cloud type
        reportType:
          type: string
          description: Report type
        mandateName:
          type: string
          description: Mandate name
        lastRunDate:
          type: string
          format: date-time
          description: Last run date
        dataLakeSearchUrl:
          type: string
          description: Data lake search URL
        requirements:
          type: array
          items:
            $ref: '#/components/schemas/CspmReportRequirementDetails'
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.armor.com/authorize
          tokenUrl: https://auth.armor.com/token
          scopes: {}