> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List data checkpoints
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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](/api-reference/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.
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.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/entities/versions/checkpoints
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/apps/{app_id}/entities/versions/checkpoints:
get:
summary: List data checkpoints
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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](/api-reference/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.
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.
operationId: >-
list_app_version_checkpoints_api_apps__app_id__entities_versions_checkpoints_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app.
title: App Id
description: ID of the app.
example: 6820f3a4e7b91d003c45a1f2
- name: entity_name
in: query
required: false
schema:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: >-
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.
title: Entity Name
description: >-
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.
example:
- Invoice
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Pagination cursor from previous response.
title: Cursor
description: Pagination cursor from previous response.
example: gAAAAABn7vJ...
- name: limit
in: query
required: false
schema:
type: integer
description: >-
Items per page. Max 200. Defaults to 50, and a larger value is
treated as 200.
default: 50
title: Limit
description: >-
Items per page. Max 200. Defaults to 50, and a larger value is
treated as 200.
example: 100
- name: from
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
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.
title: From
description: >-
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.
example: '2026-06-01T00:00:00Z'
- name: to
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
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.
title: To
description: >-
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.
example: '2026-06-08T00:00:00Z'
responses:
'200':
description: One page of checkpoints.
content:
application/json:
schema:
$ref: '#/components/schemas/CheckpointListPage'
'400':
description: >-
The cursor is malformed or was issued for different filters, `from`
or `to` isn't an ISO 8601 timestamp, or you named more than 200
entities.
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have editor access to this app, your API key is read-only,
or version history isn't on for the app. Read `state` from [Get data
version history
status](/api-reference/get-data-version-history-status) to see why.
'404':
description: App not found.
'422':
description: '`limit` isn''t a whole number.'
'429':
description: >-
Rate limit exceeded. The base limit is 70 requests per minute. See
[Rate
limits](/developers/references/apps-api/get-started/rate-limits) for
the multiplier your plan gets.
components:
schemas:
CheckpointListPage:
properties:
items:
items:
$ref: '#/components/schemas/CheckpointListItem'
type: array
title: Items
description: The page's checkpoints, newest first.
example:
- checkpoint_id: 68a1c2d3e4f5a6b7c8d9e0f1
data_as_of: '2026-06-04T14:07:02.115000Z'
entity_name: Invoice
trigger_type: crud
next_cursor:
anyOf:
- type: string
- type: 'null'
title: Next Cursor
description: >-
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: gAAAAABn7vJ...
type: object
required:
- items
title: CheckpointListPage
description: One page of an app's version-history checkpoints, newest first.
CheckpointListItem:
properties:
checkpoint_id:
type: string
title: Checkpoint Id
description: >-
ID of the checkpoint. Pass it to [Download data
checkpoint](/api-reference/download-data-checkpoint) or [Restore
data to checkpoint](/api-reference/restore-data-to-checkpoint).
example: 68a1c2d3e4f5a6b7c8d9e0f1
entity_name:
type: string
title: Entity Name
description: Entity the checkpoint belongs to.
example: Invoice
data_as_of:
type: string
title: Data As Of
description: >-
The moment the checkpoint marks, as a UTC timestamp in ISO 8601
format with a `Z` suffix. The checkpoint holds the entity's data as
it was just before this moment, so it leaves out the change that
created it.
example: '2026-06-04T14:07:02.115000Z'
trigger_type:
type: string
enum:
- crud
- schema_change
- restore
title: Trigger Type
description: >-
What created the checkpoint. `crud` means a change to a record,
`schema_change` means a change to the entity's schema, and `restore`
means the backup Base44 saves just before a restore rewrites the
entity.
example: crud
restore_batch_id:
anyOf:
- type: string
- type: 'null'
title: Restore Batch Id
description: >-
ID of the restore that saved this backup, as `batch_id` from
[Restore data to
checkpoint](/api-reference/restore-data-to-checkpoint). It is `null`
on every checkpoint that isn't a restore backup, and on backups
saved before Base44 started recording it.
example: 3f1c9a52-7b4e-4d2a-9c61-5e8f0b7a2d14
type: object
required:
- checkpoint_id
- entity_name
- data_as_of
- trigger_type
title: CheckpointListItem
description: >-
One point in an entity's version history that its data can be restored
to.
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````