Count entity records

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

Returns how many production records an entity holds.

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.

Don’t pass User as the entity_name. To count the app’s users, use Count app users instead.

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

Count entity records

cURL

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/count \
  --header 'api_key: <api-key>'

200

{
  "count": 128
}

Authorizations

api_key · string · header · required

Personal API key.

Path Parameters

entity_name · string · required

Name of the entity, exactly as List entity schemas reports it. Don't pass User here. It doesn't fail, but it reads and writes a separate, disconnected set of records stored under that name, not the app's real user accounts, which are managed through their own endpoints.

app_id · string · required

ID of the app whose entity records you want to count.

Response

200

application/json

Successful Response

The number of records stored in one of an app's entities.

count · integer · required

Number of records you can read in this entity.

Example:

128