> ## Documentation Index > Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt > Use this file to discover all available pages before exploring further. # List an application's image versions with SBOM and findings ## OpenAPI ````yaml https://platform.ankra.app/openapi.json get /api/v1/org/applications/{application_id}/security/versions openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: - url: https://platform.ankra.app security: [] tags: - name: Clusters description: Create, inspect and manage clusters, and the stacks deployed on them. - name: Managed Clusters description: Provider-managed control planes, driven through one common surface. - name: Imported Clusters description: Clusters that already existed and were connected to Ankra. - name: Cluster Access description: Kubeconfigs, service-account tokens and per-cluster access grants. - name: Kubernetes description: Read and act on the Kubernetes objects inside a cluster. - name: DigitalOcean Clusters description: Provision and manage DigitalOcean Kubernetes clusters. - name: Hetzner Clusters description: Provision and manage Hetzner Kubernetes clusters. - name: OVH Clusters description: Provision and manage OVH Kubernetes clusters. - name: Scaleway Clusters description: Provision and manage Scaleway Kapsule clusters. - name: UpCloud Clusters description: Provision and manage UpCloud Kubernetes clusters. - name: Applications description: Deploy, configure and observe applications across the fleet. - name: Stack Profiles description: Reusable stack definitions, their versions and sharing. - name: Charts description: Browse the chart catalogue behind stacks and addons. - name: Helm description: Helm registries, credentials and the charts they expose. - name: Executions description: Long-running platform executions and their jobs. - name: Operations description: Cancel in-flight cluster operations and their jobs. - name: Chat description: Conversational sessions, plans and confirmable actions. - name: AI Agent Runs description: Autonomous agent runs and their outcomes. - name: AI Tickets description: The AI ticket board, its sync connections and settings. - name: AI Playbooks description: Reusable playbooks the AI lanes execute. - name: AI Conditions description: Conditions that gate AI autonomy. - name: AI Engineering Handoffs description: Work the AI lanes escalate to a human engineer. - name: AI Environment description: The environment and base stacks AI demos deploy into. - name: Security description: Findings, advisories, SBOMs, compliance and posture. - name: Cost description: Cluster and fleet cost, rate cards and cost settings. - name: Billing description: Subscription and spend caps. - name: Organisation description: Members, invitations, audit logs and organisation settings. - name: Account Tokens description: Personal access tokens for the API and CLI. - name: Credentials description: The shared credential store. - name: Azure Credentials description: Azure credentials and SSH keys. - name: DigitalOcean Credentials description: DigitalOcean credentials and SSH keys. - name: Hetzner Credentials description: Hetzner credentials and SSH keys. - name: OVH Credentials description: OVH credentials and SSH keys. - name: Scaleway Credentials description: Scaleway credentials. - name: UpCloud Credentials description: UpCloud credentials and SSH keys. - name: Data Source Credentials description: Credentials for metrics and log sources. - name: DNS Credentials description: Credentials for DNS providers. - name: DNS description: DNS zones and records, including custom organisation zones. - name: Cloudflare description: Cloudflare domains and the credentials behind them. - name: Variables description: Organisation- and cluster-scoped variables. - name: SOPS description: Encrypt and decrypt values with the organisation SOPS config. - name: Alerts description: Alert integrations and ingest credentials. - name: Notifications description: Notification routes and their delivery targets. - name: Support description: Support tickets. paths: /api/v1/org/applications/{application_id}/security/versions: get: tags: - Applications - Security summary: List an application's image versions with SBOM and findings operationId: get_application_security_versions_api_v1 parameters: - in: path name: application_id required: true schema: type: string - in: query name: component required: false schema: type: string description: Narrow a monorepo application to one component. responses: '200': content: application/json: schema: $ref: '#/components/schemas/ApplicationImageVersionsResponse' description: >- Every pushed image version of the application with its bill of materials, findings and where it runs, the source repository's visibility, and what the licences in the newest scanned versions oblige of the application's own source. '401': content: application/json: schema: $ref: '#/components/schemas/SecurityDetailError' description: Missing, expired or revoked API token '404': content: application/json: schema: $ref: '#/components/schemas/SecurityDetailError' description: Application not found '500': content: application/json: schema: $ref: '#/components/schemas/SecurityDetailError' description: Internal server error components: schemas: ApplicationImageVersionsResponse: properties: application_id: type: string repository: $ref: '#/components/schemas/ApplicationRepository' components: items: $ref: '#/components/schemas/ApplicationImageVersionComponent' type: array versions: items: $ref: '#/components/schemas/ApplicationImageVersion' type: array summary: $ref: '#/components/schemas/ApplicationImageVersionsSummary' license_exposure: $ref: '#/components/schemas/ApplicationLicenseExposure' required: - application_id - repository - components - versions - summary - license_exposure title: ApplicationImageVersionsResponse type: object SecurityDetailError: properties: detail: type: string required: - detail type: object ApplicationRepository: properties: provider: type: string owner: type: string name: type: string visibility: type: string enum: - private - public - unknown description: >- As the platform last learned it from the Git provider; unknown is a repository the organisation has not synced, never a public one. required: - provider - owner - name - visibility title: ApplicationRepository type: object ApplicationImageVersionComponent: properties: name: type: string registry: type: string repository: type: string registry_status: description: >- listed: the registry answered and the tags are what it holds; empty: it answered that nothing has been pushed; unavailable: it could not be asked, so the registry side of this list is unknown. enum: - listed - empty - unavailable type: string message: anyOf: - type: string - type: 'null' required: - name - registry - repository - registry_status - message title: ApplicationImageVersionComponent type: object ApplicationImageVersion: properties: component: type: string registry: type: string repository: type: string tag: type: string digest: anyOf: - type: string - type: 'null' pushed_at: anyOf: - format: date-time type: string - type: 'null' sources: items: enum: - registry - sbom - findings type: string type: array sbom: $ref: '#/components/schemas/ApplicationImageVersionSbom' findings: $ref: '#/components/schemas/ApplicationImageVersionFindings' running: $ref: '#/components/schemas/ApplicationImageVersionRunning' required: - component - registry - repository - tag - digest - pushed_at - sources - sbom - findings - running title: ApplicationImageVersion type: object ApplicationImageVersionsSummary: properties: versions: type: integer with_sbom: type: integer with_findings: type: integer running: type: integer required: - versions - with_sbom - with_findings - running title: ApplicationImageVersionsSummary type: object ApplicationLicenseExposure: properties: status: type: string enum: - assessed - unavailable description: >- assessed when at least one component has a bill of materials; unavailable means nothing below is a verdict. latest: anyOf: - $ref: '#/components/schemas/SecurityLicenseExposure' - type: 'null' description: >- Per-tier counts summed over the newest scanned version of each component; null until a version has been assessed. source_disclosure_required: type: boolean description: >- The newest scanned version links a network-copyleft package (AGPL, SSPL, EUPL, OSL) and the repository is not known to be public - private, or unsynced and therefore treated as private: serving it over a network obliges publishing the source of the service that links it. service_licence_required: type: boolean description: >- The newest scanned version links a source-available package (BUSL, Elastic, Redis Source Available, Commons Clause): hosting it as a service needs a commercial licence. flagged_components: type: integer components: items: $ref: '#/components/schemas/ApplicationLicenseComponent' type: array description: >- Flagged packages, most consequential first, once per component running the image, capped at fifty; flagged_components is the uncapped count of packages. required: - status - latest - source_disclosure_required - service_licence_required - flagged_components - components title: ApplicationLicenseExposure type: object ApplicationImageVersionSbom: properties: status: enum: - present - absent type: string image_identity: anyOf: - type: string - type: 'null' component_count: anyOf: - type: integer - type: 'null' os_name: anyOf: - type: string - type: 'null' generated_at: anyOf: - format: date-time type: string - type: 'null' license_exposure: anyOf: - $ref: '#/components/schemas/SecurityLicenseExposure' - type: 'null' required: - status - image_identity - component_count - os_name - generated_at - license_exposure title: ApplicationImageVersionSbom type: object ApplicationImageVersionFindings: properties: scanned: type: boolean observed: type: integer actionable: $ref: '#/components/schemas/SecuritySeverityCounts' known_exploited: type: integer fixable_severe: type: integer last_scan_at: anyOf: - format: date-time type: string - type: 'null' required: - scanned - observed - actionable - known_exploited - fixable_severe - last_scan_at title: ApplicationImageVersionFindings type: object ApplicationImageVersionRunning: properties: workloads: type: integer clusters: type: integer namespaces: items: type: string type: array last_seen_at: anyOf: - format: date-time type: string - type: 'null' required: - workloads - clusters - namespaces - last_seen_at title: ApplicationImageVersionRunning type: object SecurityLicenseExposure: properties: network_copyleft: type: integer source_available: type: integer copyleft: type: integer weak_copyleft: type: integer permissive: type: integer unknown: type: integer required: - network_copyleft - source_available - copyleft - weak_copyleft - permissive - unknown title: SecurityLicenseExposure type: object description: >- Components per licence tier. A component the classifier has not seen yet counts as unknown, never as permissive. ApplicationLicenseComponent: properties: component: type: string tag: type: string image_identity: type: string name: type: string version: type: string package_type: type: string licenses: items: type: string type: array license_risk: type: string enum: - network_copyleft - source_available - copyleft - weak_copyleft - permissive - unknown required: - component - tag - image_identity - name - version - package_type - licenses - license_risk title: ApplicationLicenseComponent type: object SecuritySeverityCounts: properties: critical: type: integer high: type: integer low: type: integer medium: type: integer unknown: type: integer required: - critical - high - medium - low - unknown type: object ````