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

# List Models

> List all models with pagination support

# List Models

Retrieve a paginated list of all models in your account.

## Query Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `status` | string | No | - | Filter models by status |
| `page` | integer | No | 1 | Page number (must be >= 1) |
| `per_page` | integer | No | 10 | Number of items per page (must be between 1 and 100) |

## Headers

| Header | Type | Required | Description |
| - | - | - | - |
| `X-Enkrypt-Refresh-Cache` | boolean | No | Refresh the cache if data is stale |

## Example Request

```bash theme={"system"}
curl -X GET "https://api.enkryptai.com/models/list-models?page=1&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Enkrypt-Refresh-Cache: false"
```

## Example Response

```json theme={"system"}
{
  "models": [
    {
      "model_id": "1234567890",
      "model_saved_name": "Test Model",
      "model_version": "v1",
      "created_at": "2025-02-21T09:28:52.651201+00:00",
      "updated_at": "2025-02-21T09:28:52.651201+00:00",
      "testing_for": "foundationModels",
      "model_name": "meta-llama/Llama-3.3-70B-Instruct-Turbo",
      "project_name": "default"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total_count": 25,
    "total_pages": 3,
    "has_next": true,
    "has_previous": false
  }
}
```

## Error Responses

### 400 Bad Request - Invalid Pagination Parameters

```json theme={"system"}
{
  "error": "Invalid pagination parameters. Page must be >= 1, per_page must be between 1 and 100"
}
```

## Pagination

The response includes pagination metadata to help you navigate through the results:

* `page`: Current page number
* `per_page`: Number of items per page
* `total_count`: Total number of items across all pages
* `total_pages`: Total number of pages
* `has_next`: Boolean indicating if there's a next page
* `has_previous`: Boolean indicating if there's a previous page

To get the next page, increment the `page` parameter. For example, to get page 2:

```
GET /models/list-models?page=2&per_page=10
```


## OpenAPI

````yaml GET /models/list-models
openapi: 3.0.0
info:
  title: Enkrypt AI APIs
  version: 2.0.0
servers:
  - url: https://api.enkryptai.com
security:
  - apiKeyAuth: []
tags:
  - name: Guardrails
  - name: Code of Conduct
  - name: Endpoints
  - name: Redteam
    description: >-
      Red Team API: submit red-team / threat-modeling / playground / eval runs,
      then poll run status, records, results and compliance. Also two-phase
      threat modeling (categories + data), dataset retrieval, model health,
      findings and risk mitigation. The previous task-based Red Team API is
      under **Archived**.
  - name: Deployments
  - name: AI Proxy
  - name: Leaderboard
  - name: Archived
  - name: MCP Hub
    description: >-
      MCP Hub vulnerability scanning APIs. Submitting scans (the POST endpoints)
      is open to all authenticated callers. The scan **retrieval** APIs — Get
      Scan Job Status, Get Complete Scan Results, List Scans, and Get MCP Hub
      Scan Statistics (the GET endpoints) — are an **enterprise data-license
      feature**: they require your organization to have MCP Hub API access
      enabled by Enkrypt, otherwise they return `403`. Contact us at
      support@enkryptai.com to enable access.
  - name: MCP Registry Servers
  - name: MCP Gateways
  - name: MCP Playground
  - name: Skill Scanner
    description: >-
      Skill Scanner APIs: submit an agent skill (a directory inside a git
      repository) for security scanning, then read the verdict, the risk level
      and the full report. Scanning is asynchronous — a scan takes roughly 30–90
      seconds, so `POST /skill-hub/scan` returns a `scan_id` you poll.


      You see your organization's scans and nobody else's. The identity comes
      from your API key, never from your request — sending `user_email` is a
      `400`.


      For an organization or project API key, scans are filed under the
      **organization**, so every member sees every scan the organization has
      run, whichever project or member submitted it. For an individual account
      it is simply your own scans. Either way List Skill Scans needs no
      parameter to say who you are.
  - name: Compliance
    description: >-
      Compliance APIs: connect a ChatGPT Enterprise workspace, then keep reading
      its compliance logs and scanning every message through one of your saved
      guardrails.


      Every endpoint here — reads as well as writes — requires the **governance
      officer** role on the project your API key belongs to. The organization
      owner is **not** exempt: an owner who has not been granted the role gets
      `403` like anyone else. An individual (non-organization) account cannot
      hold the role at all, so compliance is an organization-only feature today.


      A scan is addressed by name in the `X-Enkrypt-Scan` header, within the
      project its API key belongs to. Message text is never stored: Get
      Compliance Message fetches it live from the provider, and only while the
      provider still holds it.
paths:
  /models/list-models:
    get:
      tags:
        - Endpoints
      summary: List Models
      operationId: list_models
      parameters:
        - name: X-Enkrypt-Refresh-Cache
          in: header
          required: false
          schema:
            title: Refresh Cache
            type: boolean
            description: Refresh the cache if data is stale
            example: false
        - in: query
          name: status
          required: false
          schema:
            title: Status
            type: string
            description: Filter models by status
        - in: query
          name: page
          required: false
          schema:
            title: Page
            type: integer
            default: 1
            minimum: 1
            example: 1
            description: Page number (must be >= 1)
        - in: query
          name: per_page
          required: false
          schema:
            title: Per Page
            type: integer
            default: 10
            minimum: 1
            maximum: 100
            example: 10
            description: Number of items per page (must be between 1 and 100)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListModelsResponseObject'
        '400':
          description: Bad Request - Invalid pagination parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Invalid pagination parameters. Page must be >= 1, per_page
                      must be between 1 and 100
components:
  schemas:
    ListModelsResponseObject:
      title: ListModelsResponseObject
      type: object
      properties:
        models:
          title: models
          type: array
          items:
            title: Model
            type: object
            properties:
              model_id:
                title: model_id
                type: string
              model_saved_name:
                title: model_saved_name
                type: string
              model_version:
                title: model_version
                type: string
              created_at:
                title: created_at
                type: string
              updated_at:
                title: updated_at
                type: string
              testing_for:
                title: testing_for
                type: string
              model_name:
                title: model_name
                type: string
              project_name:
                title: project_name
                type: string
        pagination:
          title: Pagination
          type: object
          properties:
            page:
              title: Page
              type: integer
              example: 1
              description: Current page number
            per_page:
              title: Per Page
              type: integer
              example: 10
              description: Number of items per page
            total_count:
              title: Total Count
              type: integer
              example: 25
              description: Total number of items
            total_pages:
              title: Total Pages
              type: integer
              example: 3
              description: Total number of pages
            has_next:
              title: Has Next
              type: boolean
              example: true
              description: Whether there is a next page
            has_previous:
              title: Has Previous
              type: boolean
              example: false
              description: Whether there is a previous page
      example:
        models:
          - model_id: '1234567890'
            model_saved_name: Test Model
            model_version: v1
            created_at: '2025-02-21T09:28:52.651201+00:00'
            updated_at: '2025-02-21T09:28:52.651201+00:00'
            testing_for: foundationModels
            model_name: meta-llama/Llama-3.3-70B-Instruct-Turbo
            project_name: default
        pagination:
          page: 1
          per_page: 10
          total_count: 25
          total_pages: 3
          has_next: true
          has_previous: false
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: apikey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.