Get subscription cost by month

Request#

GET /api/v1/dashboard/subscription-cost

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

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

Query parameters#

timeframe string Optional

3 or 6 months back, ytd (since January), year (12 months back), 2year, 3year, or all. Defaults to 3.

categories[] integer array Optional

Up to 100 subscription category IDs to include. Defaults to every subscription category. An ID that is not a subscription category in this organization returns 422.

Example#

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

curl --globoff --request GET "https://my.assetcenter.app/api/v1/dashboard/subscription-cost?timeframe=6&categories[]=9" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK.

{
  "data": {
    "timeframe": "6",
    "data": [
      {
        "date": "2026-08-01",
        "cost": 1180.5
      },
      {
        "date": "2026-09-01",
        "cost": 1180.5
      },
      {
        "date": "2026-10-01",
        "cost": 1240
      }
    ],
    "subscription_categories": [
      {
        "id": 9,
        "name": "Software"
      }
    ],
    "selected_categories": [
      9
    ]
  }
}

Behavior and constraints#

data.data has one point per month, from the start of the timeframe through the current month, dated on the first of the month. cost is the estimated spend for that month on subscriptions billed as subscription, following each subscription’s billing changes, pauses, cancellations, and retirements over time. all starts the month before the earliest subscription history. subscription_categories lists every subscription category so you can offer a filter, and selected_categories echoes the categories used. When no category is selected, data.data is empty. The example is abbreviated to three months.

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.