---
title: "Entity Introspection"
method: GET
path: "/v1/entities/{entity_id}/introspection"
tags: ["API v1", "Entities"]
---

# Entity Introspection

`GET /v1/entities/{entity_id}/introspection`

Get the field schema for a real-world entity by its numeric UUID — the schema spans many domains,
illustrative not exhaustive. Use to look up / find out what an entity is queryable for before
pulling its profile. Returns the available properties, relationships, and numerical observations
you can request from `entity_retrieval`.


Examples:

`GET /entities/c6772802-bdbc-4778-91e9-cd3d27d008d5/introspection`

`GET /entities/e5bb591a-d308-4aa5-9672-96046d366cde/introspection`


Use this when: You have an entity UUID and need to discover which attributes and relationships exist before
querying. Use `entity_retrieval` to fetch data, or `entity_search` first if you only have a name.

## Path parameters

- `entity_id` string, uuid, required

## Response `200`

Successful Response

- IntrospectionResponse — Response containing the introspection of an entity.
  - `properties` string[], required — List of property names available for this entity (e.g. id, name, currency).
  - `relationships` IntrospectionEntityRelationships, required — Outgoing and incoming relationship types for an entity.
    - `outgoing` string[] — Outgoing relationship type names.
    - `incoming` string[] — Incoming relationship type names.
  - `numerical_observations` object, required — List of numerical observation names available for this entity.

## Other responses

- `422` — Validation Error
- `429` — Too many requests (rate limit exceeded)

---

[API](https://skmtc.net/cala/apis/cala-ai.md) · [All operations](https://skmtc.net/cala/apis/cala-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cala/cala-ai/versions/ee1ba9729aeb/schema)