> For the complete documentation index, see [llms.txt](https://deepmode.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://deepmode.gitbook.io/docs/api-endpoints/handling-models/show-model-list.md).

# Show Model List

Retrieves a list of existing models.

#### Endpoint

```
GET /api/models
```

#### Parameters

<table><thead><tr><th width="212">Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td>string</td><td>No</td><td>Search term to filter models by name.</td></tr><tr><td><code>page</code></td><td>integer</td><td>No</td><td>Page number for pagination. </td></tr><tr><td><code>page_size</code></td><td>integer</td><td>No</td><td>Page size for pagination. </td></tr></tbody></table>

#### Request Example

{% code overflow="wrap" %}

```bash
curl -X GET "https://api.deepmode.ai/api/models?name=model" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_SECRET_API_KEY"
```

{% endcode %}

#### Response

Upon successful retrieval, the API returns the following response:

```json
{
  "models": [
    {
      "id": "c6b8a9f7e5d1c3a2f91e3",
      "name": "My model",
      "gender": "woman",
      "active": true,
      "created_at": "2024-04-01T12:00:00Z",
      "expire_at": "2024-05-01T12:00:00Z"
    },
    {
      "id": "d5c6b8a9f7e5d1c3a2f91",
      "name": "Another model",
      "gender": "man",
      "active": true,
      "created_at": "2024-04-05T15:30:00Z",
      "expire_at": "2024-05-05T15:30:00Z"
    }
  ],
  "total_models": 2
}

```