---
title: "List entity schemas"
method: GET
path: "/api/apps/{app_id}/entity-schemas"
---

# List entity schemas

`GET /api/apps/{app_id}/entity-schemas`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns every entity schema the app defines, plus the built-in `User` entity when it has custom fields.

Each entry pairs the entity name with its JSON Schema: the entity's `properties`, its `required` fields, and its row-level security rules under `rls`. To read one schema on its own, use [Get entity schema](/api-reference/get-entity-schema).

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

## Path parameters

- `app_id` string, required — ID of the app whose entity schemas you want.

## Response `200`

The app's entity schemas.

- ListEntitySchemasResponse
  - `schemas` EntitySchema[], required — The app's entity schemas.
    - `entity_name` string, required — Name of the entity. `User` is the built-in user entity; every other name is one the app defines.
    - `entity_schema` object, required — The entity's JSON Schema, including its `properties`, `required` fields, and any `rls` rules. For `User` this holds only the custom fields added on top of the built-in ones.
  - `total` integer, required — Number of schemas in `schemas`.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, or you used a workspace API key.
- `404` — App not found.
- `422` — Validation Error

## Changes

- **2026-08-25** `8dfd9c46c0b9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/entity-schemas/get.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/31ef75eb64ab/schema)