{"meta":{"apiVersion":"2026-08-01","correlationId":"req-2026-08-25-00006","generatedAt":"2026-08-25T09:00:00.000Z","source":"demo-generator"},"data":{"name":"DCS Client Insights API","version":"2026-08-01","status":"prototype — demo data, no authentication","authentication":"Entra ID application or delegated token (not implemented in the prototype)","resources":[{"path":"/api/v1/customers","description":"Customer master data; supports ?q=, ?page=, ?pageSize="},{"path":"/api/v1/customers/{id}","description":"One customer with branding, agreement and freshness"},{"path":"/api/v1/customers/{id}/overview","description":"Headline KPIs for the current period"},{"path":"/api/v1/customers/{id}/m365/users","description":"Users from the latest snapshot"},{"path":"/api/v1/customers/{id}/m365/licences","description":"Purchased, assigned and available by SKU"},{"path":"/api/v1/customers/{id}/support/summary","description":"Eligible records, response, resolution, SLA"},{"path":"/api/v1/customers/{id}/assets","description":"Equipment inventory with contract cover"},{"path":"/api/v1/customers/{id}/contracts","description":"Contract lines, agreement type and renewal dates"},{"path":"/api/v1/customers/{id}/alerts","description":"Findings with evidence and rule version"},{"path":"/api/v1/groups","description":"Customer groups with rollups"},{"path":"/api/v1/groups/{id}","description":"One group and its member sites"},{"path":"/api/v1/pipeline","description":"Sales pipeline records"},{"path":"/api/v1/renewals","description":"Contract lines reaching their end date; ?withinDays="},{"path":"/api/v1/sync-jobs","description":"Collection status per customer"}],"notes":["Every response carries meta.correlationId, meta.generatedAt and source freshness.","Identifiers in URLs are the immutable internal CustomerId, never a name or domain.","Support, asset and contract resources return SOURCE_UNAVAILABLE for customers with no SQL mapping."]}}