Newer Version Available
Get Dashboard Results
You can get dashboard metadata, data, and status by sending
a GET request to the Dashboard Results resource.
Use a GET request to the Dashboard Results resource to retrieve metadata, data, and status for a dashboard and its components. The results response contains:
- Metadata: information about the dashboard as a whole, including the dashboard ID, name, component metadata, and any dashboard filters.
- Data: underlying report data for each component, filtered by the optional filter parameters. For more information about filtering, see Filter Dashboard Results.
- Status: data and refresh status for each component of the dashboard. The data status can be NODATA, DATA, or ERROR. If an error occurs, the component status will contain additional properties with the error code, message, and severity. The refresh status can be IDLE, if components are finished running, or RUNNING, if components are still being refreshed.
- Example Usage
-
1/services/data/v31.0/analytics/dashboards/01ZD00000007S89MAE - Example Response Body
-
1{ 2 "componentData" : [ { 3 "componentId" : "01aD0000000a36LIAQ", 4 "reportResult" : { 5 "attributes" : null, 6 "allData" : true, 7 "factMap" : { 8 "T!T" : { 9 "aggregates" : [ { 10 "label" : "USD 67,043,365.50", 11 "value" : 67043365.50166918337345123291015625 12 } ] 13 }, 14 "0!T" : { 15 "aggregates" : [ { 16 "label" : "USD 10,083.33", 17 "value" : 10083.333333333333939663134515285491943359375 18 } ] 19 }, 20 "1!T" : { 21 "aggregates" : [ { 22 "label" : "USD 25,016,768.67", 23 "value" : 25016768.670066006481647491455078125 24 } ] 25 }, 26 "2!T" : { 27 "aggregates" : [ { 28 "label" : "USD 42,016,513.50", 29 "value" : 42016513.49826984107494354248046875 30 } ] 31 } 32 }, 33 "groupingsAcross" : null, 34 "groupingsDown" : { 35 "groupings" : [ { 36 "groupings" : [ ], 37 "key" : "0", 38 "label" : "-", 39 "value" : null 40 }, { 41 "groupings" : [ ], 42 "key" : "1", 43 "label" : "Existing Business", 44 "value" : "Existing Business" 45 }, { 46 "groupings" : [ ], 47 "key" : "2", 48 "label" : "New Business", 49 "value" : "New Business" 50 } ] 51 }, 52 "hasDetailRows" : false, 53 "reportExtendedMetadata" : { 54 "aggregateColumnInfo" : { 55 "s!AMOUNT" : { 56 "acrossGroupingContext" : null, 57 "dataType" : "currency", 58 "downGroupingContext" : null, 59 "label" : "Sum of Amount" 60 } 61 }, 62 "detailColumnInfo" : { }, 63 "groupingColumnInfo" : { 64 "TYPE" : { 65 "dataType" : "picklist", 66 "groupingLevel" : 0, 67 "label" : "Type" 68 } 69 } 70 }, 71 "reportMetadata" : { 72 "aggregates" : [ "s!AMOUNT" ], 73 "currency" : "USD", 74 "detailColumns" : [ ], 75 "developerName" : "Simple_Test", 76 "groupingsAcross" : [ ], 77 "groupingsDown" : [ { 78 "dateGranularity" : "None", 79 "name" : "TYPE", 80 "sortAggregate" : null, 81 "sortOrder" : "Asc" 82 } ], 83 "historicalSnapshotDates" : [ ], 84 "id" : "00OD0000001g2nWMAQ", 85 "name" : "Simple Test", 86 "reportBooleanFilter" : null, 87 "reportFilters" : [ ], 88 "reportFormat" : "SUMMARY", 89 "reportType" : { 90 "label" : "Opportunities", 91 "type" : "Opportunity" 92 } 93 } 94 }, 95 "status" : { 96 "dataStatus" : "DATA", 97 "errorCode" : null, 98 "errorMessage" : null, 99 "errorSeverity" : null, 100 "refreshDate" : "2014-04-09T00:28:16.000+0000", 101 "refreshStatus" : "IDLE" 102 } 103 } ], 104 "dashboardMetadata" : { 105 "attributes" : { 106 "dashboardId" : "01ZD00000007S89MAE", 107 "dashboardName" : "Simple Dashboard", 108 "statusUrl" : "/services/data/v31.0/analytics/dashboards/01ZD00000007S89MAE/status", 109 "type" : "Dashboard" 110 }, 111 "canChangeRunningUser" : false, 112 "components" : [ { 113 "componentData" : 0, 114 "footer" : null, 115 "header" : null, 116 "id" : "01aD0000000a36LIAQ", 117 "properties" : { 118 "aggregateName" : "s!AMOUNT", 119 "maxRows" : null, 120 "sort" : { 121 "column" : "TYPE", 122 "sortOrder" : "asc" 123 }, 124 "visualizationProperties" : { }, 125 "visualizationType" : "Bar" 126 }, 127 "reportId" : "00OD0000001g2nWMAQ", 128 "title" : null, 129 "type" : "Report" 130 } ], 131 "description" : null, 132 "developerName" : "Simple_Dashboard", 133 "filters" : [ { 134 "name" : "Amount", 135 "options" : [ { 136 "alias" : null, 137 "endValue" : null, 138 "id" : "0ICD00000004CBiOAM", 139 "operation" : "greaterThan", 140 "startValue" : null, 141 "value" : "USD 2000000" 142 } ], 143 "selectedOption" : null 144 } ], 145 "id" : "01ZD00000007S89MAE", 146 "layout" : { 147 "columns" : [ { 148 "components" : [ 0 ] 149 } ] 150 }, 151 "name" : "Simple Dashboard", 152 "runningUser" : { 153 "displayName" : "Allison Wheeler", 154 "id" : "005D00000016V2qIAE" 155 } 156 } 157}