Get application by key | LaunchDarkly

curl https://app.launchdarkly.com/api/v2/applications/applicationKey \
     -H "Authorization: <apiKey>"

{
  "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": 1,
  "creationDate": 1654104600000,
  "description": "The LaunchDarkly Cafe app",
  "_maintainer": {
    "member": {
      "_links": {
        "self": {
          "href": "/api/v2/members/569f183514f4432160000007",
          "type": "application/json"
        }
      },
      "_id": "569f183514f4432160000007",
      "role": "admin",
      "email": "ariel@acme.com",
      "firstName": "Ariel",
      "lastName": "Flores"
    },
    "team": {
      "customRoleKeys": [
        "access-to-test-projects"
      ],
      "key": "team-key-123abc",
      "name": "QA Team",
      "_links": {}
    }
  }
}

Retrieve an application by the application key. ### Expanding the application response LaunchDarkly supports expanding the "Get application" 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.

curl https://app.launchdarkly.com/api/v2/applications/applicationKey \
     -H "Authorization: <apiKey>"

{
  "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": 1,
  "creationDate": 1654104600000,
  "description": "The LaunchDarkly Cafe app",
  "_maintainer": {
    "member": {
      "_links": {
        "self": {
          "href": "/api/v2/members/569f183514f4432160000007",
          "type": "application/json"
        }
      },
      "_id": "569f183514f4432160000007",
      "role": "admin",
      "email": "ariel@acme.com",
      "firstName": "Ariel",
      "lastName": "Flores"
    },
    "team": {
      "customRoleKeys": [
        "access-to-test-projects"
      ],
      "key": "team-key-123abc",
      "name": "QA Team",
      "_links": {}
    }
  }
}

Retrieve an application by the application key.

Expanding the application response

LaunchDarkly supports expanding the “Get application” 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.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

applicationKeystringRequiredformat: "string"

The application key

Query parameters

expandstringOptionalformat: "string"

A comma-separated list of properties that can reveal additional information in the response. Options: flags.

Response

Application response

autoAddedboolean

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.

keystring

The unique identifier of this application

kindenum

To distinguish the kind of application

Allowed values:

namestring

The name of the application

flagsobject

Details about the flags that have been evaluated by the application

_accessobject

Details on the allowed and denied actions for this application

_linksmap from strings to objects

The location and content type of related resources

_versioninteger

Version of the application

creationDatelong

Timestamp of when the application version was created

descriptionstring

The application description

_maintainerobject

Associated maintainer member or team info for the application

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

$	curl https://app.launchdarkly.com/api/v2/applications/applicationKey \
>	-H "Authorization: <apiKey>"

1	{
2	"autoAdded": true,
3	"key": "com.launchdarkly.cafe",
4	"kind": "mobile",
5	"name": "LaunchDarklyCafe",
6	"flags": {
7	"items": [
8	{
9	"name": "Example flag",
10	"key": "flag-key-123abc",
11	"_links": {},
12	"_site": {
13	"href": "string",
14	"type": "string"
15	}
16	}
17	],
18	"totalCount": 1,
19	"_links": {}
20	},
21	"_access": {
22	"denied": [
23	{
24	"action": "string",
25	"reason": {
26	"effect": "allow",
27	"resources": [
28	"proj/:env/;qa_:/flag/"
29	],
30	"notResources": [
31	"string"
32	],
33	"actions": [
34	"*"
35	],
36	"notActions": [
37	"string"
38	],
39	"role_name": "string"
40	}
41	}
42	],
43	"allowed": [
44	{
45	"action": "string",
46	"reason": {
47	"effect": "allow",
48	"resources": [
49	"proj/:env/;qa_:/flag/"
50	],
51	"notResources": [
52	"string"
53	],
54	"actions": [
55	"*"
56	],
57	"notActions": [
58	"string"
59	],
60	"role_name": "string"
61	}
62	}
63	]
64	},
65	"_links": {},
66	"_version": 1,
67	"creationDate": 1654104600000,
68	"description": "The LaunchDarkly Cafe app",
69	"_maintainer": {
70	"member": {
71	"_links": {
72	"self": {
73	"href": "/api/v2/members/569f183514f4432160000007",
74	"type": "application/json"
75	}
76	},
77	"_id": "569f183514f4432160000007",
78	"role": "admin",
79	"email": "ariel@acme.com",
80	"firstName": "Ariel",
81	"lastName": "Flores"
82	},
83	"team": {
84	"customRoleKeys": [
85	"access-to-test-projects"
86	],
87	"key": "team-key-123abc",
88	"name": "QA Team",
89	"_links": {}
90	}
91	}
92	}