monday.get

You can use the monday.get software development kit (SDK) method to retrieve data from the parent monday.com application where your app is currently running. This object can only be used in client-side apps.

Parameters

  • type: The type of requested information (available values below)
  • params: Reserved for future use

The available types that can be requested are:

TypeDescription
'context'Information about where this app is currently displayed, depending on the type of feature
'settings'The application settings as configured by the user that installed the app
'itemIds'The list of item IDs that are filtered in the current board (or all items if no filters are applied)
'sessionToken'A JWT token that is decoded with your app's secret and can be used as a session token between your app's frontend and backend
'filter'The state of the Search filter

Returns

A Promise that will be resolved with the requested data.

Examples

Requesting context and settings data

monday.get("settings").then(res => ...);
monday.get("context").then(res => ...);

Context objects that return for board views, item views, and dashboard widgets

{
  "theme": "light", // or "dark" or "hacker_theme"
  "account": {
    "id": "5" // unique account ID
  },
  "user": {
    "id": "2631211", // unique user ID
    "isAdmin": false, // or true
    "isGuest": false, // or true
    "isViewOnly": false, // or true
    "countryCode": "IL", // user's two-letter country code
    "currentLanguage": "en", // user's default language
    "timeFormat": "12H", // or "24H"
    "timeZoneOffset": 3 // time zone offset based on GMT
  },
  "region": "use1", // availability zone ID
  "app": {
    "id": 10000205, // unique app ID
    "clientId": "120372d8b9047cb85966f070ca0ee490" // unique client ID
  },
  "appVersion": {
    "id": 10000345, // unique app version ID
    "name": "Shay Test App API Context - New App", // name of the app's current version
    "status": "draft", // or "live"
    "type": "major", // or "minor"
    "versionData": {
      "major": 1, // version number
      "minor": 0, // version number
      "patch": 0, // patch number
      "type": "major" // or "minor"
    }
  },
  "boardId": 118405813, // unique board ID
  "boardIds": [
    118405813 // list of connected boards
  ],
  "boardViewId": 10887, // unique board view ID
  "viewMode": "fullScreen", // or "split" or "widget"
  "instanceId": 10887, // unique instance ID for the feature on the board
  "instanceType": "board_view", // feature type
  "workspaceId": 7870, // unique workspace ID 
}
{
  "theme": "hacker_theme", // or "light" or "dark"
  "account": {
    "id": "654646" // unique account ID
  },
  "user": {
    "id": "65464", // unique user ID
    "isAdmin": false, // or true 
    "isGuest": false, // or true 
    "isViewOnly": false, // or true
    "countryCode": "IL", // user's two-letter country code
    "currentLanguage": "en", // user's default language
    "timeFormat": "24H", // or "12H"
    "timeZoneOffset": 3 // time zone offset based on GMT
  },
  "region": "use1", // availability zone ID
  "productKind": "core",
  "app": {
    "id": 64541082, // unique app ID
    "clientId": "d5be5bbc7re646g76b9988a6ad64d780" // unique client ID
  },
  "appVersion": {
    "id": 6458043, // unique app version ID
    "name": "New App", // name of the app's current version
    "status": "draft", // or "live"
    "type": "major", // or "minor"
    "versionData": {
      "major": 1, // version number
      "minor": 0, // version number
      "patch": 0, // patch number 
      "type": "major" // or "minor"
    }
  },
  "workspaceId": 1350535, // unique workspace ID
  "boardId": 6456619824, // unique board IF
  "boardIds": [
    6454619824 // list of connected boards
  ],
  "itemId": 64564519872, // unique item ID
  "instanceId": 65461164, // unique instance ID for the feature on the board
  "instanceType": "item_view" // feature type
}
{
  "theme": "hacker_theme", // or "dark" or "light"
  "account": {
    "id": "654646" // unique account ID
  },
  "user": {
    "id": "65464", // unique user ID
    "isAdmin": false, // or true
    "isGuest": false, // or true
    "isViewOnly": false, // or true
    "countryCode": "IL", // user's two-letter country code
    "currentLanguage": "en", // user's default language
    "timeFormat": "24H", // or "12H"
    "timeZoneOffset": 3 // time zone offset based on GMT
  },
  "region": "use1", // availability zone ID
  "productKind": "core",
  "app": {
    "id": 64541082, // unique app ID
    "clientId": "d5be5bbc7re646g76b9988a6ad64d780" // unique client ID
  },
  "appVersion": {
    "id": 6458043, // unique app version ID
    "name": "New App", // name of the app's current version
    "status": "draft", // or "live"
    "type": "major", // or "minor"
    "versionData": {
      "major": 1, // version number
      "minor": 0, // version number
      "patch": 0, // patch number
      "type": "major" // or "minor"
    }
  },
  "boardIds": [
    53459894065 // list of connected boards
  ],
  "widgetId": 5435359808, // unique widget ID
  "viewMode": "widget" // or "fullscreen" or "split"
  "editMode": true, // or false
  "instanceId": 543359808, // unique instance ID for the feature on the board
  "instanceType": "dashboard_widget" // feature type
}

Requesting the list of items currently in view in the board

monday.get("itemIds").then(res => console.log(res));
// => [234234, 4564, 234234, 67675, 576567]