Get applications

For the complete documentation index, see llms.txt. For the full documentation snapshot, see llms-full.txt.

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.

GET /api/v2/applications

Get applications

cURL

curl --request GET \
  --url https://app.launchdarkly.com/api/v2/applications \
  --header 'Authorization: <api-key>'

200

{
  "_links": {},
  "items": [
    {
      "autoAdded": true,
      "key": "com.launchdarkly.cafe",
      "kind": "mobile",
      "name": "LaunchDarklyCafe",
      "flags": {
        "items": [
          {
            "name": "Example flag",
            "key": "flag-key-123abc",
            "_links": {},
            "_site": {
              "href": "<string>",
              "type": "<string>"
            }
          }
        ],
        "totalCount": 1,
        "_links": {}
      },
      "_access": {
        "denied": [
          {
            "action": "<string>",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "<string>"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "<string>"
              ],
              "role_name": "<string>"
            }
          }
        ],
        "allowed": [
          {
            "action": "<string>",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "<string>"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "<string>"
              ],
              "role_name": "<string>"
            }
          }
        ]
      },
      "_links": {},
      "_version": 123,
      "creationDate": "1654104600000",
      "description": "The LaunchDarkly Cafe app",
      "_maintainer": {
        "member": {
          "_links": {
            "self": {
              "href": "/api/v2/members/569f183514f4432160000007",
              "type": "application/json"
            }
          },
          "_id": "569f183514f4432160000007",
          "role": "admin",
          "email": "[e-mail]",
          "firstName": "Ariel",
          "lastName": "Flores"
        },
        "team": {
          "customRoleKeys": [
            "access-to-test-projects"
          ],
          "key": "team-key-123abc",
          "name": "QA Team",
          "_links": {}
        }
      }
    }
  ],
  "totalCount": 1
}

Authorizations

Authorization · string · header · required

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.

limit · integer<int64>

The number of applications to return. Defaults to 10.

offset · integer<int64>

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

application/json

Applications response

_links · object

The location and content type of related resources

Show child attributes

items · object[]

A list of applications

Show child attributes

totalCount · integer

The number of applications

Example:

1