> ## 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 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: 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.
                    total_memories:
                      type: integer
                      description: Total number of memories associated with the entity.
                    owner:
                      type: string
                      description: Owner of the entity.
                    organization:
                      type: string
                      description: Organization the entity belongs to.
                    metadata:
                      type: object
                      description: Additional metadata associated with the entity
                    type:
                      type: string
                      enum:
                        - user
                        - agent
                        - app
                        - run
                  required:
                    - id
                    - name
                    - created_at
                    - updated_at
                    - total_memories
                    - owner
                    - organization
                    - type
      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'

````