List data checkpoints

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

Returns the points in the app's entity data history that you can download or restore to, newest first.

Base44 adds one when an entity's records change (at most one every 5 minutes for each entity), when its schema changes, and just before a restore rewrites it. The list covers every entity in the app unless you name some with entity_name, and only reaches back as far as retention_days from Get data version history status.

Results use cursor-based pagination. Pass next_cursor from one response as cursor on the next request, and keep the same filters.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted.</Note>

get/api/apps/{app_id}/entities/versions/checkpoints

Path parameters

app_idstring required

ID of the app.

ID of the app.

Query parameters

entity_namestring[] nullable

Entity to list checkpoints for. Repeat it to list several, as in ?entity_name=Invoice&entity_name=Customer, up to 200. Leave it out to list every entity's checkpoints. A name the app has no entity for matches nothing rather than failing.

Entity to list checkpoints for. Repeat it to list several, as in ?entity_name=Invoice&entity_name=Customer, up to 200. Leave it out to list every entity's checkpoints. A name the app has no entity for matches nothing rather than failing.

cursorstring nullable

Pagination cursor from previous response.

Pagination cursor from previous response.

limitinteger

Items per page. Max 200. Defaults to 50, and a larger value is treated as 200.

Items per page. Max 200. Defaults to 50, and a larger value is treated as 200.

fromstring nullable

Earliest data_as_of to include, as an ISO 8601 timestamp such as 2026-06-01T00:00:00Z. A timestamp with no offset is read as UTC.

Earliest data_as_of to include, as an ISO 8601 timestamp such as 2026-06-01T00:00:00Z. A timestamp with no offset is read as UTC.

tostring nullable

Only include checkpoints whose data_as_of is before this moment, as an ISO 8601 timestamp such as 2026-06-08T00:00:00Z. A timestamp with no offset is read as UTC.

Only include checkpoints whose data_as_of is before this moment, as an ISO 8601 timestamp such as 2026-06-08T00:00:00Z. A timestamp with no offset is read as UTC.

Response

One page of checkpoints.

next_cursorstring nullable

Cursor for fetching the next page. The value is null if there are no more pages. A full page always carries one, so the page after it can come back empty.

Example response

{
  "items": [
    {
      "checkpoint_id": "68a1c2d3e4f5a6b7c8d9e0f1",
      "data_as_of": "2026-06-04T14:07:02.115000Z",
      "entity_name": "Invoice",
      "trigger_type": "crud"
    }
  ],
  "next_cursor": "gAAAAABn7vJ..."
}

Changes

Changed in 1 of the 33 revisions of this API.1