Events API Fresh

Track and monitor memory operation events for dashboards, alerting, and audit logging.

Base URL: https://api.mem0.ai

Authentication: Authorization: Token <MEM0_API_KEY>

---

Get Events (List)

GET /v1/events/

List recent events for your organization and project.

Use Cases

• Dashboards — Summarize additions/searches over time
• Alerting — Poll for FAILED events to trigger workflows
• Audit logging — Compliance documentation

Response (200)

{
  "count": 100,
  "next": "https://api.mem0.ai/v1/events/?page=2",
  "previous": null,
  "results": [
    {
      "id": "uuid",
      "event_type": "ADD",
      "status": "SUCCEEDED",
      "payload": {},
      "metadata": null,
      "results": [],
      "created_at": "2024-07-15T10:30:00Z",
      "updated_at": "2024-07-15T10:30:00Z",
      "started_at": "2024-07-15T10:30:00Z",
      "completed_at": "2024-07-15T10:30:01Z",
      "latency": 150.5
    }
  ]
}

Event Status Values

Status	Description
PENDING	Event queued for processing
RUNNING	Currently being processed
FAILED	Processing failed
SUCCEEDED	Completed successfully

Python

import requests

response = requests.get(
    "https://api.mem0.ai/v1/events/",
    headers={"Authorization": "Token your-api-key"}
)
events = response.json()

cURL

curl --request GET \
  --url 'https://api.mem0.ai/v1/events/' \
  --header 'Authorization: Token <api-key>'

---

Get Event (Single)

GET /v1/event/{event_id}/

Retrieve details of a specific event by ID, including status and payload for async memory operations.

Path Parameters

Parameter	Type	Required	Description
event_id	string (UUID)	Yes	The unique event identifier.

Response (200)

{
  "id": "uuid",
  "event_type": "ADD",
  "status": "SUCCEEDED",
  "payload": {},
  "metadata": null,
  "results": [],
  "created_at": "2024-07-15T10:30:00Z",
  "updated_at": "2024-07-15T10:30:00Z",
  "started_at": "2024-07-15T10:30:00Z",
  "completed_at": "2024-07-15T10:30:01Z",
  "latency": 150.5
}

Error (404)

Returns a detail string describing why the event was not found.

Python

import requests

response = requests.get(
    "https://api.mem0.ai/v1/event/{event_id}/",
    headers={"Authorization": "Token your-api-key"}
)
event = response.json()

cURL

curl --request GET \
  --url 'https://api.mem0.ai/v1/event/{event_id}/' \
  --header 'Authorization: Token <api-key>'