> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mem0.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Events

> List recent events for your organization and project, useful for dashboards, alerting, and audit logging.

List recent events for your organization and project.

## Use Cases

* **Dashboards**: Summarize adds/searches over time by paging through events.
* **Alerting**: Poll for `FAILED` events and trigger follow-up workflows.
* **Audit**: Store the returned payload/metadata for compliance logs.


## OpenAPI

````yaml get /v1/events/
openapi: 3.0.1
info:
  title: Mem0 API Docs
  description: mem0.ai API Docs
  contact:
    email: support@mem0.ai
  license:
    name: Apache 2.0
  version: v1
servers:
  - url: https://api.mem0.ai/
security:
  - ApiKeyAuth: []
paths:
  /v1/events/:
    get:
      tags:
        - events
      summary: Retrieve all events for current organization and project.
      operationId: events_list
      responses:
        '200':
          description: Successfully retrieved events.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    description: Total number of events matching the filters.
                  next:
                    type: string
                    nullable: true
                    description: URL for the next page of results.
                  previous:
                    type: string
                    nullable: true
                    description: URL for the previous page of results.
                  results:
                    type: array
                    description: Array of event objects.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: The unique identifier of the event.
                        event_type:
                          type: string
                          description: The type of event (e.g., ADD, SEARCH).
                        status:
                          type: string
                          enum:
                            - PENDING
                            - RUNNING
                            - FAILED
                            - SUCCEEDED
                          description: The current status of the event.
                        payload:
                          type: object
                          description: The original payload associated with the event.
                        metadata:
                          type: object
                          nullable: true
                          description: Additional metadata associated with the event.
                        results:
                          type: array
                          description: >-
                            Array of results produced by the event. For add
                            events, this confirms the write completed; temporal
                            reasoning enrichment runs asynchronously by default.
                        created_at:
                          type: string
                          format: date-time
                          description: Timestamp when the event was created.
                        updated_at:
                          type: string
                          format: date-time
                          description: Timestamp when the event was last updated.
                        started_at:
                          type: string
                          format: date-time
                          description: Timestamp when event processing started.
                        completed_at:
                          type: string
                          format: date-time
                          description: Timestamp when event processing completed.
                        latency:
                          type: number
                          description: Processing time in milliseconds.
                required:
                  - count
                  - results
      x-code-samples:
        - lang: Python
          source: |-
            import requests

            url = "https://api.mem0.ai/v1/events/"

            headers = {"Authorization": "Token <api-key>"}

            response = requests.request("GET", url, headers=headers)

            print(response.text)
        - lang: JavaScript
          source: >-
            const options = {method: 'GET', headers: {Authorization: 'Token
            <api-key>'}};


            fetch('https://api.mem0.ai/v1/events/', options)
              .then(response => response.json())
              .then(response => console.log(response))
              .catch(err => console.error(err));
        - lang: cURL
          source: |-
            curl --request GET \
              --url https://api.mem0.ai/v1/events/ \
              --header 'Authorization: Token <api-key>'
        - lang: Go
          source: "package main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"io/ioutil\"\n)\n\nfunc main() {\n\n\turl := \"https://api.mem0.ai/v1/events/\"\n\n\treq, _ := http.NewRequest(\"GET\", url, nil)\n\n\treq.Header.Add(\"Authorization\", \"Token <api-key>\")\n\n\tres, _ := http.DefaultClient.Do(req)\n\n\tdefer res.Body.Close()\n\tbody, _ := ioutil.ReadAll(res.Body)\n\n\tfmt.Println(res)\n\tfmt.Println(string(body))\n\n}"
        - lang: PHP
          source: |-
            <?php

            $curl = curl_init();

            curl_setopt_array($curl, [
              CURLOPT_URL => "https://api.mem0.ai/v1/events/",
              CURLOPT_RETURNTRANSFER => true,
              CURLOPT_ENCODING => "",
              CURLOPT_MAXREDIRS => 10,
              CURLOPT_TIMEOUT => 30,
              CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
              CURLOPT_CUSTOMREQUEST => "GET",
              CURLOPT_HTTPHEADER => [
                "Authorization: Token <api-key>"
              ],
            ]);

            $response = curl_exec($curl);
            $err = curl_error($curl);

            curl_close($curl);

            if ($err) {
              echo "cURL Error #:" . $err;
            } else {
              echo $response;
            }
        - lang: Java
          source: >-
            HttpResponse<String> response =
            Unirest.get("https://api.mem0.ai/v1/events/")
              .header("Authorization", "Token <api-key>")
              .asString();
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API key authentication. Prefix your Mem0 API key with 'Token '. Example:
        'Token your_api_key'

````