Get all installations of an app within an organization

GET

https://api.contentful.com/app_definitions/:app_definition_id/app_installations

GET

/app_definitions/:app_definition_id/app_installations

$ curl https://api.contentful.com/app_definitions/app_definition_id/app_installations \
>      -H "sys.organization.sys.id[in]: organization_id" \
>      -H "Authorization: Bearer <token>"

200App installations_getAllInstallationsOfAnAppWithinAnOrganization_example

1 {
2   "sys": {
3     "type": "Array"
4   },
5   "items": [
6     {
7       "sys": {
8         "type": "AppInstallation",
9         "appDefinition": {
10           "sys": {
11             "type": "Link",
12             "linkType": "AppDefinition",
13             "id": "<app_definition_id>"
14           }
15         },
16         "createdAt": "2025-05-06T12:06:22.000Z",
17         "createdBy": {
18           "sys": {
19             "type": "Link",
20             "linkType": "User",
21             "id": "7BslKh9TdKGOK41VmLDjFZ"
22           }
23         },
24         "updatedAt": "2025-05-06T12:06:22.000Z",
25         "updatedBy": {
26           "sys": {
27             "type": "Link",
28             "linkType": "User",
29             "id": "7BslKh9TdKGOK41VmLDjFZ"
30           }
31         },
32         "space": {
33           "sys": {
34             "type": "Link",
35             "linkType": "Space",
36             "id": "yadj1kx9rmg0"
37           }
38         },
39         "environment": {
40           "sys": {
41             "type": "Link",
42             "linkType": "Environment",
43             "id": "staging"
44           }
45         }
46       },
47       "parameters": {
48         "hello": "world"
49       }
50     }
51   ],
52   "includes": {
53     "Environment": [
54       {
55         "sys": {
56           "id": "staging",
57           "type": "Environment",
58           "createdAt": "2025-12-10T04:24:39.000Z",
59           "updatedAt": "2025-12-10T04:24:39.000Z",
60           "createdBy": {
61             "sys": {
62               "type": "Link",
63               "linkType": "User",
64               "id": "75cxRYbSLlWMlCrN1tZGdP"
65             }
66           },
67           "updatedBy": {
68             "sys": {
69               "type": "Link",
70               "linkType": "User",
71               "id": "75cxRYbSLlWMlCrN1tZGdP"
72             }
73           },
74           "version": 1,
75           "status": {
76             "sys": {
77               "type": "Link",
78               "linkType": "Status",
79               "id": "ready"
80             }
81           },
82           "space": {
83             "sys": {
84               "type": "Link",
85               "linkType": "Space",
86               "id": "yadj1kx9rmg0"
87             }
88           }
89         },
90         "name": "environment"
91       }
92     ]
93   }
94 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

app_definition_idstringRequired

app_definition_id identifier

organization_idstringRequired

organization_id identifier

Headers

sys.organization.sys.id[in]stringRequired

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful