List expiring contracts

Request#

GET /api/v1/dashboard/expiring-contracts

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

1, 3, 6, 12, 24, or 36 months ahead, or year for the rest of this calendar year. Defaults to 3.

already_eol boolean Optional

Send 1 to also include contracts that have already ended. Defaults to 0.

page integer Optional

The page of results to return. Starts at 1; defaults to 1.

per_page integer Optional

The maximum number of results per page. Accepts 1–100; defaults to 25.

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/expiring-contracts?timeframe=3" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK.

{
  "data": [
    {
      "id": 88,
      "vendor_name": "Example Software",
      "name": "Team software",
      "plan_type": null,
      "contract_end_date": "2026-11-30"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 1
  },
  "links": {
    "next": null,
    "prev": null
  }
}

Behavior and constraints#

Paused and cancelled subscriptions are left out. Results are ordered by contract_end_date, soonest first.

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.