Get entity record

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

Returns one record from one of the app's entities.

Row-level security applies to the read, so a record the caller's rls read rule doesn't cover reports 404, the same as a record that was never there or has been deleted.

The response carries the entity's own fields alongside the ones Base44 adds. This endpoint has no fields parameter, so it always returns the whole record. Use List entity records when you want only some of a record's fields.

This endpoint is limited to 150 requests per minute per app.

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

get/api/apps/{app_id}/entities/{entity_name}/{entity_id}

Path parameters

entity_idstring required

ID of the record, as id in the response of List entity records.

app_idstring required

ID of the app that owns the entity.

entity_namestring required

Name of the entity, exactly as List entity schemas reports it.

Response

The record.

idstring nullable

ID of the record. Pass it as entity_id to Get entity record, Update entity record or Delete entity record.

created_datestring nullable

When the record was created, as a UTC timestamp in ISO 8601 format. A record Base44 has just created carries a Z suffix, and a record read back from storage does not.

updated_datestring nullable

When the record last changed, as a UTC timestamp in ISO 8601 format. A record Base44 has just created carries a Z suffix, and a record read back from storage does not.

created_bystring nullable

Email of the app user who created the record, or anonymous when a visitor created it on an app that needs no login. Apps that hide record authorship leave this field out of the response.

created_by_idstring nullable

ID of the app user who created the record, or anonymous when a visitor created it on an app that needs no login.

is_sampleboolean nullable

Whether Base44 stored the record as sample data while the app was being built. A record you create reports false.

Example response

{
  "id": "6886b8d390dc7e2f4a2c91b3",
  "created_date": "2026-06-01T09:23:41.481000",
  "updated_date": "2026-06-04T14:07:02.115000",
  "created_by": "jane@acme.com",
  "created_by_id": "6874b0c2e1a94d0031bb77de"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.