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>
Path parameters
ID of the app.
ID of the app.
Query parameters
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.
Pagination cursor from previous response.
Pagination cursor from previous response.
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.
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.
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.
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
- ○
endpoint added
endpoint-added
- ○