Get asset summary metrics

Returns computed asset metrics: health status/reason, security status/issues, warranty status and days remaining, and open ticket count.

RBAC · asset

Path parameters

idstring <uuid>Required

Asset UUID from assets.asset_id.

Response body

Success response 200 · schema AssetSummaryResponse

health_statusstring

Enum: healthywarningcriticalunknown

health_reasonstring

security_statusstring

Enum: secureat_riskcritical

security_issuesarray of string

itemsstring

warranty_statusstring

Enum: no_warrantyexpiredexpiring_soonactive

warranty_days_remainingnumberNullable

open_tickets_countnumber

Response codes

200

Asset summary metrics.

401

x-api-key missing/invalid.

403

Caller lacks the required asset permission.

404

Asset not found.

500

Unexpected error.

GET /api/v1/assets/{id}/summary

cURL

curl -X GET "https://algapsa.com/api/v1/assets/{id}/summary" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/v1/assets/{id}/summary", {
  method: "GET",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://algapsa.com/api/v1/assets/{id}/summary");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "health_status": "healthy",
  "health_reason": "string",
  "security_status": "secure",
  "security_issues": [
    "string"
  ],
  "warranty_status": "no_warranty",
  "warranty_days_remaining": 0,
  "open_tickets_count": 0
}