> ## Documentation Index
> Fetch the complete documentation index at: https://mem0-feature-memo-claude-plugin-v1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Users

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



## OpenAPI

````yaml get /v1/entities/
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/entities/:
    get:
      tags:
        - entities
      operationId: entities_list
      parameters:
        - name: org_id
          in: query
          schema:
            type: string
          description: Filter entities by organization ID.
        - name: project_id
          in: query
          schema:
            type: string
          description: Filter entities by project ID.
      responses:
        '200':
          description: Successfully retrieved list of entities.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    description: Total number of entities matching the filters.
                  next:
                    type: string
                    nullable: true
                    description: >-
                      URL of the next page of results, or null if this is the
                      last page.
                  previous:
                    type: string
                    nullable: true
                    description: >-
                      URL of the previous page of results, or null if this is
                      the first page.
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier for the entity.
                        name:
                          type: string
                          description: Name of the entity.
                        created_at:
                          type: string
                          format: date-time
                          description: Timestamp of when the entity was created.
                        updated_at:
                          type: string
                          format: date-time
                          description: Timestamp of when the entity was last updated.
                        owner:
                          type: string
                          description: Owner of the entity.
                        metadata:
                          type: object
                          nullable: true
                          description: Additional metadata associated with the entity.
                        type:
                          type: string
                          enum:
                            - user
                            - agent
                            - app
                            - run
                      required:
                        - id
                        - name
                        - created_at
                        - updated_at
                        - owner
                        - type
                  total_users:
                    type: integer
                    description: Total number of user entities in the project.
                  total_agents:
                    type: integer
                    description: Total number of agent entities in the project.
                  total_apps:
                    type: integer
                    description: Total number of app entities in the project.
                  total_runs:
                    type: integer
                    description: Total number of run entities in the project.
                required:
                  - count
                  - next
                  - previous
                  - results
      x-code-samples:
        - lang: Python
          source: |-
            # 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)
        - lang: JavaScript
          source: |-
            // To use the JavaScript SDK, install the package:
            // npm i mem0ai

            import MemoryClient from 'mem0ai';
            const client = new MemoryClient({ apiKey: "your-api-key" });

            // Retrieve all users
            client.users()
              .then(result => console.log(result))
              .catch(error => console.error(error));
        - lang: cURL
          source: |-
            curl --request GET \
              --url https://api.mem0.ai/v1/entities/ \
              --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/entities/\"\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/entities/",
              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/entities/")
              .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'

````