---
title: "List App Versions"
method: GET
path: "/api/v2/app-builder/apps/{app_id}/versions"
tags: ["App Builder"]
---

# List App Versions

`GET /api/v2/app-builder/apps/{app_id}/versions`

List the versions of an app. This endpoint is paginated.

## Path parameters

- `app_id` string, uuid, required

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

OK

- ListAppVersionsResponse — A paginated list of versions for an app.
  - `data` AppVersion[] — The list of app versions.
    - `attributes` AppVersionAttributes — Attributes describing an app version.
      - `app_id` string, uuid — The ID of the app this version belongs to.
      - `created_at` string, date-time — Timestamp of when the version was created.
      - `has_ever_been_published` boolean — Whether this version has ever been published.
      - `name` string — The optional human-readable name of the version.
      - `updated_at` string, date-time — Timestamp of when the version was last updated.
      - `user_id` integer — The ID of the user who created the version.
      - `user_name` string — The name (or email) of the user who created the version.
      - `user_uuid` string, uuid — The UUID of the user who created the version.
      - `version` integer — The version number of the app, starting at 1.
    - `id` string, uuid — The ID of the app version.
    - `type` 'appVersions' — The app-version resource type.
  - `meta` ListAppsResponseMeta — Pagination metadata.
    - `page` ListAppsResponseMetaPage — Information on the total number of apps, to be used for pagination.
      - `totalCount` integer — The total number of apps under the Datadog organization, disregarding any filters applied.
      - `totalFilteredCount` integer — The total number of apps that match the specified filters.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)