Get Installed Plug-ins

Gets the list of plug-ins imported into Kintone.

MethodGET
URLhttps://{subdomain}.kintone.com/k/v1/plugins.json
Authentication Password Authentication , Session Authentication
Content-Typeapplication/json (not needed if specifying the query with a query string)

Contents

Permissions

  • No permissions are needed.

Request Parameters

Parameter Value Required Description
offset Integer The number of plug-ins to skip from the list of installed plug-ins.
If ignored, this value is 0.
limit Integer The maximum number of plug-ins to retrieve.
Must be between 1 and 100.
The default number is 100.

Sample Request

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
var body = {
  'offset': 1,
  'limit': 3
};
kintone.api(kintone.api.url('/k/v1/plugins.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

curl Sample

1
2
3
4
5
6
curl -X GET 'https://{subdomain}.kintone.com/k/v1/plugins.json' \
  -H 'X-Cybozu-Authorization:{AuthorizationCode}' \
  -H 'Content-Type: application/json' \
  -d '{
    "offset": 1, "limit": 3
  }'

Response Parameters

Parameter Type Description
plugins Array of Objects A list of plug-ins added to the App.
Plug-ins are listed in descending order of the datetime they are added.
plugins[].id String The plug-in ID.
plugins[].name String The name of the plug-in.
plugins[].isMarketPlugin Boolean States whether or not the plug-in is a Marketplace plug-in.
  • true: The plug-in is a Marketplace plug-in.
  • false: The plug-in is not a Marketplace plug-in.
plugins[].version String The version number of the plug-in.

Sample Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
    "plugins": [
        {
          "id": "djmhffjhfgmebgnmcggopedaofckljlj",
          "name": "Plugin 1",
          "isMarketPlugin": false,
          "version": "1"
        },
        {
          "id":"ejgcopfamifdhmkafjgidfmgjdmiaplf",
          "name":"Plugin 2",
          "isMarketPlugin":false,
          "version":"2"
        },
        {
          "id":"fdeplpmkengkldpdlaiegpokgmaabkkb",
          "name":"Plugin 3",
          "isMarketPlugin":false,
          "version":"4.5.1"
          }
    ]
}