---
title: "Get entity schema"
method: GET
path: "/api/apps/{app_id}/entity-schemas/{entity_name}"
---

# Get entity schema

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

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

Returns one entity's JSON Schema: its `properties`, its `required` fields, and its row-level security rules under `rls`. Use [List entity schemas](/api-reference/list-entity-schemas) to see which entity names the app has.

For the app's own entities the schema also carries a `name` key holding the entity name, which Base44 sets on every write. The `User` schema does not have one.

Pass `User` as the `entity_name` to read the custom fields added to the built-in user entity. That returns only those custom fields, not the built-in ones, and returns a 404 when the app has not added any.

<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

- `entity_name` string, required — Name of the entity, as returned by [List entity schemas](/api-reference/list-entity-schemas). Pass `User` for the built-in user entity.
- `app_id` string, required — ID of the app whose entity schemas you want.

## Response `200`

Successful Response

- object — The entity's JSON Schema, as stored.

## 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, the app has no entity with this name, or `User` was requested and the app has no custom user fields.

## Changes

- **2026-08-30** `394136a6cdd4` — 1 info
  - removed the non-success response with the status `422`
- **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/:entity_name/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/394136a6cdd4/schema)