---
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.

To read one schema on its own, use [Get entity schema](/api-reference/get-entity-schema).

## Path parameters

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

## Response `200`

Successful Response

- ListEntitySchemasResponse — Every entity the app defines, with its schema.
  - `schemas` EntitySchema[], required — The app's entity schemas.
    - `entity_name` string, required — Name of the entity. The name `User` is the built-in user entity, and every other name is one the app defines.
    - `entity_schema` object, required — The entity's stored [JSON Schema](/developers/backend/resources/entities/entity-schemas), including its `properties`, `required` fields, and any [row-level security rules](/developers/backend/resources/entities/security) under `rls`. For the app's own entities it also carries a `name` key holding the entity name. For `User` it holds only the custom fields added on top of the built-in ones, and has no `name` key.
  - `total` integer, required — Number of entity schemas returned.

## 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.

---

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