---
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`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/app-builder/apps/{app_id}/versions`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)