---
title: "GET /v1/entities/"
method: GET
path: "/v1/entities/"
tags: ["entities"]
---

# GET /v1/entities/

`GET /v1/entities/`

## Query parameters

- `org_id` string
- `project_id` string

## Response `200`

Successfully retrieved list of entities.

- object
  - `count` integer, required — Total number of entities matching the filters.
  - `next` string, nullable, required — URL of the next page of results, or null if this is the last page.
  - `previous` string, nullable, required — URL of the previous page of results, or null if this is the first page.
  - `results` object[], required
    - `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.
    - `owner` string, required — Owner of the entity.
    - `metadata` object, nullable — Additional metadata associated with the entity.
    - `type` 'user' | 'agent' | 'app' | 'run', required
  - `total_users` integer — Total number of user entities in the project.
  - `total_agents` integer — Total number of agent entities in the project.
  - `total_apps` integer — Total number of app entities in the project.
  - `total_runs` integer — Total number of run entities in the project.

---

[API](https://skmtc.net/mem0/apis/mem0-api-docs.md) · [All operations](https://skmtc.net/mem0/apis/mem0-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mem0/mem0-api-docs/revisions/c86fe9831e7e/schema)