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

# List Entities

`GET /entities`

List entities for the current app, paginated by id.

`cursor` is typed as ``uuid.UUID`` so FastAPI rejects malformed values
with 422 before they reach the query layer (was 500 when parsing was
deferred to ``uuid.UUID(cursor)`` inside the query helper).

## Query parameters

- `type` string, nullable
- `search` string, nullable
- `limit` integer
- `cursor` string, uuid, nullable

## Response `200`

Successful Response

- EntityListResponse
  - `items` EntityResponse[], required
    - `id` string, uuid, required
    - `type` string, required
    - `name` string, required
    - `description` string, nullable
    - `attributes` object
    - `mention_count` integer, required
    - `first_seen_resource_id` string, nullable
    - `last_seen_resource_id` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error

---

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