Skip to main content
GET
/
v1
/
entities
/
Python
# To use the Python SDK, install the package:
# pip install mem0ai

from mem0 import MemoryClient
client = MemoryClient(api_key="your_api_key", org_id="your_org_id", project_id="your_project_id")
users = client.users()
print(users)
[
  {
    "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": {},
    "type": "user"
  }
]

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