Get the deployed assets chart

Request#

GET /api/v1/dashboard/deployed-assets-chart

Requires reports:read and assets:read. See dashboard report permissions.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

Query parameters#

option string Optional

category (default) counts deployed assets by category, manufacturer counts deployed assets by manufacturer, and statuses counts all assets by status.

Example#

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example record and option IDs with values from your organization.

curl --request GET "https://my.assetcenter.app/api/v1/dashboard/deployed-assets-chart?option=category" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK.

{
  "data": {
    "option": "category",
    "labels": [
      "Laptops",
      "Monitors",
      "Uncategorized"
    ],
    "data": [
      212,
      88,
      12
    ]
  }
}

Behavior and constraints#

labels and data are parallel arrays in label order: data[0] is the count for labels[0]. Assets without a category are grouped as Uncategorized, and assets without a manufacturer as Unknown. The statuses option includes every status, not just deployed assets.

Errors#

401 means the token is missing, expired, revoked, or not a customer API token. 403 means a required permission or administrator access is missing. 422 identifies invalid or unsupported input; inspect the errors object when present. 429 means a rate limit was reached. See error handling and rate limits.