---
title: "List Model Cards"
method: GET
path: "/models/v4/cards"
tags: ["sensors_other"]
---

# List Model Cards

`GET /models/v4/cards`

## Query parameters

- `model_name` object
  - `contains` string
  - `eq` string
- `model_created` object
  - `lte` string, date-time
  - `gte` string, date-time
- `aidr_severity` string[]
- `aidr_status` 'ENABLED' | 'DISABLED' | 'ANY'
- `modscan_severity` union[]
  - union
    - 'SAFE' | 'UNSAFE' | 'SUSPICIOUS' | 'UNKNOWN' | 'ERROR' — Use ScanDetectionsV3.yaml#/ScanDetectionSeverity instead.
    - 'critical' | 'high' | 'medium' | 'low' | 'none' | 'unknown' — The highest severity of any detections on the scan.
- `policy_status` string[]
- `modscan_status` 'ENABLED' | 'DISABLED' | 'ANY'
- `source` object
  - `contains` string
  - `eq` string
- `provider` string[]
- `limit` integer — Maximum number of items to return
- `offset` integer — Begin returning the results from this offset
- `sort` string

## Response `200`

Successful response

- ModelCardV4QueryResponse
  - `total_count` integer, required
  - `page_size` integer, required
  - `page_number` integer, required
  - `results` object[], required
    - `model_id` string, uuid, required
    - `created_at` integer, required — Unix Nano Epoch Timestamp
    - `plaintext_name` string, required
    - `source` string, required
    - `tags` object
    - `model_scan_threat_level` 'safe' | 'unsafe' | 'suspicious' | 'not available', required
    - `attack_monitoring_threat_level` 'safe' | 'unsafe' | 'suspicious' | 'not available', required
    - `aidr_threat_level` 'high' | 'medium' | 'low' | 'none' | 'not available'
    - `security_posture` SecurityPosture
      - `model_scan` boolean
      - `attack_monitoring` boolean
    - `active_version_count` integer, required
    - `has_genealogy` boolean, required — A value of `true` indicates that one or more versions of this model have associated model genealogy information.
    - `model_scan_severity` 'not available' | 'critical' | 'high' | 'medium' | 'low' | 'none' | 'unknown', required — The severity of the model's latest scan
    - `model_scan_has_error` boolean — True if the model's latest scan has an error
    - `policy_status` 'COMPLIANT' | 'COMPLIANT_OVERRIDDEN' | 'NONCOMPLIANT' | 'NONCOMPLIANT_OVERRIDDEN' — The status of the model's compliance with regard to any policies. A trailing asterisk indicates the model's status has been overridden.
    - `latest_scan_id` string, uuid — The ID of the most recent model scanner scan for this model's latest version. Absent if no scan has been run.

## Other responses

- `400` — The request failed due to a client error, with one or more of the following possible causes: 1. The request required a tenant_id field, which was missing. 2. The request was malformed syntactically or semantically.

---

[API](https://skmtc.net/hiddenlayerai/apis/hiddenlayer-audit-api.md) · [All operations](https://skmtc.net/hiddenlayerai/apis/hiddenlayer-audit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiddenlayerai/hiddenlayer-audit-api/revisions/efca861e915b/schema)