Get Users

Retrieve a list of all user entities stored in the Mem0 platform using the GET endpoint.

GET /v1/entities

Python

Python

# To use the Python SDK, install the package:
# pip install mem0ai

from mem0 import MemoryClient
client = MemoryClient(api_key="your_api_key")
users = client.users()
print(users)

200

[
  {
    "id": "<string>",
    "name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "total_memories": 123,
    "owner": "<string>",
    "organization": "<string>",
    "metadata": {}
  }
]

Authorizations

Authorization · string · header · required

API key authentication. Prefix your Mem0 API key with 'Token '. Example: 'Token your_api_key'

Query Parameters

org_id · string

Filter entities by organization ID.

project_id · string

Filter entities by project ID.

Response

200 - application/json

Successfully retrieved list of entities.

id · string · required

Unique identifier for the entity.

name · string · required

Name of the entity.

created_at · string<date-time> · required

Timestamp of when the entity was created.

updated_at · string<date-time> · required

Timestamp of when the entity was last updated.

total_memories · integer · required

Total number of memories associated with the entity.

owner · string · required

Owner of the entity.

organization · string · required

Organization the entity belongs to.

type · enum<string> · required

Available options: user, agent, app, run

metadata · object

Additional metadata associated with the entity