---
title: "Get applications"
method: GET
path: "/api/v2/applications"
tags: ["Applications (beta)"]
---

# Get applications

`GET /api/v2/applications`

Get a list of applications.

### Expanding the applications response

LaunchDarkly supports expanding the "Get applications" response to include additional fields.

To expand the response, append the `expand` query parameter and include the following:

* `flags` includes details on the flags that have been evaluated by the application

For example, use `?expand=flags` to include the `flags` field in the response. By default, this field is **not** included in the response.

## Query parameters

- `filter` string, string — Accepts filter by `key`, `name`, `kind`, and `autoAdded`. To learn more about the filter syntax, read [Filtering applications and application versions](https://launchdarkly.com/docs/api/applications-beta#filtering-applications-and-application-versions).
- `limit` integer — The number of applications to return. Defaults to 10.
- `offset` integer — Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- `sort` string, string — Accepts sorting order and fields. Fields can be comma separated. Possible fields are `creationDate`, `name`. Examples: `sort=name` sort by names ascending, `sort=-name,creationDate` sort by names descending and creationDate ascending.
- `expand` string, string — A comma-separated list of properties that can reveal additional information in the response. Options: `flags`.

## Response `200`

Applications response

- ApplicationCollectionRep
  - `_links` object — The location and content type of related resources
  - `items` ApplicationRep[] — A list of applications
    - `flags` ApplicationFlagCollectionRep
      - `items` FlagListingRep[] — A list of the flags that have been evaluated by the application
        - `name` string, required — The flag name
        - `key` string, required — The flag key
        - `_links` object
        - `_site` Link
          - `href` string
          - `type` string
      - `totalCount` integer — The number of flags that have been evaluated by the application
      - `_links` object — The location and content type of related resources
    - `_access` Access
      - `denied` AccessDenied[], required
        - `action` string, required
        - `reason` AccessDeniedReason, required
          - `resources` string[] — Resource specifier strings
          - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
          - `actions` ActionSpecifier[] — Actions to perform on a resource
          - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
          - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
          - `role_name` string
      - `allowed` AccessAllowedRep[], required
        - `action` string, required
        - `reason` AccessAllowedReason, required
          - `resources` string[] — Resource specifier strings
          - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
          - `actions` ActionSpecifier[] — Actions to perform on a resource
          - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
          - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
          - `role_name` string
    - `_links` object — The location and content type of related resources
    - `_version` integer — Version of the application
    - `autoAdded` boolean, required — Whether the application was automatically created because it was included in a context when a LaunchDarkly SDK evaluated a feature flag, or was created through the LaunchDarkly UI or REST API.
    - `creationDate` integer
    - `description` string — The application description
    - `key` string, required — The unique identifier of this application
    - `kind` 'browser' | 'mobile' | 'server', required — To distinguish the kind of application
    - `_maintainer` MaintainerRep
      - `member` MemberSummary
        - `_links` object, required — The location and content type of related resources
        - `_id` string, required — The member's ID
        - `firstName` string — The member's first name
        - `lastName` string — The member's last name
        - `role` string, required — The member's base role. If the member has no additional roles, this role will be in effect.
        - `email` string, required — The member's email address
      - `team` MemberTeamSummaryRep
        - `customRoleKeys` string[], required — A list of keys of the custom roles this team has access to
        - `key` string, required — The team key
        - `_links` object
        - `name` string, required — The team name
    - `name` string, required — The name of the application
  - `totalCount` integer — The number of applications

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Invalid resource identifier
- `429` — Rate limited

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)