List expiring warranties

Request#

GET /api/v1/dashboard/expiring-warranties

Requires reports:read and assets: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 warranties 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-warranties?timeframe=3" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK.

{
  "data": [
    {
      "id": 123,
      "asset_tag": "LAP-042",
      "manufacturer": "Lenovo",
      "model": "ThinkPad T14",
      "warranty": {
        "name": "Manufacturer warranty",
        "end_date": "2026-11-15"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 1
  },
  "links": {
    "next": null,
    "prev": null
  }
}

Behavior and constraints#

Results are ordered by warranty end date, soonest first. An asset with several warranties appears once for each warranty in range.

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.