---
title: List Minds
sidebarTitle: List Minds
---

This API endpoint lists all created Minds using the `GET` method.

### Body

None.

### Response

<ResponseField name="created_at" type="string" required>  

Timestamp of when the Mind was created.

</ResponseField>

<ResponseField name="datasources" type="array" required>  

List of data sources connected to the Mind.

</ResponseField>

<ResponseField name="model_name" type="string">  

The name of the model associated with the Mind.

</ResponseField>

<ResponseField name="name" type="string" required>  

The unique name of the Mind.

</ResponseField>

<ResponseField name="parameters" type="object">  

Optional parameters used when configuring the Mind.

</ResponseField>

<ResponseField name="provider" type="string">  

The provider used for the Mind (e.g., openai).

</ResponseField>

<ResponseField name="updated_at" type="string">  

Timestamp of the last update to the Mind.

</ResponseField>

### Authorization

A valid API key must be passed in the `Authorization` header:

```
Authorization: Bearer MINDS_API_KEY
```

Generate your [API key here](https://mdb.ai/apiKeys).

### Path Parameters

None.

<RequestExample>

```shell Shell
curl --request GET \
     --url 'https://mdb.ai/api/projects/mindsdb/minds' \
     --header 'Authorization: Bearer MINDS_API_KEY'
```

```python Python
from minds.client import Client

client = Client("MINDS_API_KEY", "https://mdb.ai/")

client.minds.list()
```

</RequestExample>

<ResponseExample>

```json Response
[
    {
        "created_at": "Wed, 07 Aug 2024 10:50:31 GMT",
        "datasources": [
            "datasource_name"
        ],
        "model_name": "gpt-4o",
        "name": "mind_name",
        "parameters": {},
        "provider": "openai",
        "updated_at": "Wed, 07 Aug 2024 16:43:21 GMT"
    }
]
```

</ResponseExample>
