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

Pass `User` as the `entity_name` to read the custom fields added to the built-in user entity.

## 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 to work with.

## Response `200`

Successful Response

- object — The entity's stored JSON Schema, including its `properties`, `required` fields, and any row-level security rules 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.

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

---

[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)