---
title: "Count entity records"
method: GET
path: "/api/apps/{app_id}/entities/{entity_name}/count"
---

# Count entity records

`GET /api/apps/{app_id}/entities/{entity_name}/count`

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

Returns how many records an entity holds. Deleted records are not counted.

The count covers the records the calling credential can read, so an entity whose row-level security rules narrow reads returns a smaller number than the entity actually holds. An entity with no `rls` rules returns its full count.

Pass the entity name exactly as [List entity schemas](/api-reference/list-entity-schemas) reports it. To count the app's users, use [Count app users](/api-reference/count-app-users) instead. The `User` entity is served by its own endpoint and never reaches this one.

This endpoint is limited to 100 requests per minute per app, shared with the app's other entity listing calls.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. Workspace API keys are not accepted.</Note>

## Path parameters

- `entity_name` string, required
- `app_id` string, required — ID of the app.

## Response `200`

Successful Response

- EntityCountResponse — The number of records stored in one of an app's entities.
  - `count` integer, required — Number of records you can read in this entity.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app.
- `404` — App not found, or the app has no entity with this name.
- `429` — Rate limit exceeded (100 requests per minute).

## 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/entities/:entity_name/count/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)