---
title: "List Apps"
method: GET
path: "/api/v2/app-builder/apps"
tags: ["App Builder"]
---

# List Apps

`GET /api/v2/app-builder/apps`

List all apps, with optional filters and sorting. This endpoint is paginated. Only basic app information such as the app ID, name, and description is returned by this endpoint. This API requires a [registered application key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). Alternatively, you can configure these permissions [in the UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access).

## Query parameters

- `limit` integer
- `page` integer
- `filter[user_name]` string
- `filter[user_uuid]` string, uuid
- `filter[name]` string
- `filter[query]` string
- `filter[deployed]` boolean
- `filter[tags]` string
- `filter[favorite]` boolean
- `filter[self_service]` boolean
- `sort` AppsSortField[]

## Response `200`

OK

- ListAppsResponse — A paginated list of apps matching the specified filters and sorting.
  - `data` ListAppsResponseDataItems[] — An array of app definitions.
    - `attributes` ListAppsResponseDataItemsAttributes, required — Basic information about the app such as name, description, and tags.
      - `description` string — A human-readable description for the app.
      - `favorite` boolean — Whether the app is marked as a favorite by the current user.
      - `name` string — The name of the app.
      - `selfService` boolean — Whether the app is enabled for use in the Datadog self-service hub.
      - `tags` string[] — A list of tags for the app, which can be used to filter apps.
    - `id` string, uuid, required — The ID of the app.
    - `meta` AppMeta — Metadata of an app.
      - `created_at` string, date-time — Timestamp of when the app was created.
      - `deleted_at` string, date-time — Timestamp of when the app was deleted.
      - `org_id` integer — The Datadog organization ID that owns the app.
      - `updated_at` string, date-time — Timestamp of when the app was last updated.
      - `updated_since_deployment` boolean — Whether the app was updated since it was last published. Published apps are pinned to a specific version and do not automatically update when the app is updated.
      - `user_id` integer — The ID of the user who created the app.
      - `user_name` string — The name (or email address) of the user who created the app.
      - `user_uuid` string, uuid — The UUID of the user who created the app.
      - `version` integer — The version number of the app. This starts at 1 and increments with each update.
    - `relationships` ListAppsResponseDataItemsRelationships — The app's publication information.
      - `deployment` DeploymentRelationship — Information pointing to the app's publication status.
        - `data` DeploymentRelationshipData — Data object containing the deployment ID.
          - `id` string, uuid — The deployment ID.
          - `type` 'deployment' — The deployment type.
        - `meta` DeploymentMetadata — Metadata object containing the publication creation information.
          - `created_at` string, date-time — Timestamp of when the app was published.
          - `user_id` integer — The ID of the user who published the app.
          - `user_name` string — The name (or email address) of the user who published the app.
          - `user_uuid` string, uuid — The UUID of the user who published the app.
    - `type` 'appDefinitions', required — The app definition type.
  - `included` Deployment[] — Data on the version of the app that was published.
    - `attributes` DeploymentAttributes — The attributes object containing the version ID of the published app.
      - `app_version_id` string, uuid — The version ID of the app that was published. For an unpublished app, this is always the nil UUID (`00000000-0000-0000-0000-000000000000`).
    - `id` string, uuid — The deployment ID.
    - `meta` DeploymentMetadata — Metadata object containing the publication creation information.
      - `created_at` string, date-time — Timestamp of when the app was published.
      - `user_id` integer — The ID of the user who published the app.
      - `user_name` string — The name (or email address) of the user who published the app.
      - `user_uuid` string, uuid — The UUID of the user who published the app.
    - `type` 'deployment' — The deployment 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
- `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)