VEverdun
site summaries

List Site Summaries

One date's summaries across the caller's in-scope sites.

date=today returns the computed "today so far" view (counts and escalations only, capped — see the service). Any other value is a site-local calendar date and returns stored rows plus a stub for any date a stretched window swallowed.

get/site-summaries

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/site-summaries
  • Auth
    HTTP bearer

Query parameters

datestring

Site-local YYYY-MM-DD, or 'today' for the live view.

parent_idstring uuid nullable
account_idstring uuid nullable
site_idsstring[] nullable

Response

Successful Response

datestring required

The date this response is about: YYYY-MM-DD, or the literal 'today' for the live view.

liveboolean required

True when every item is a computed 'today so far' row.

live_partialboolean required

True when the live view was capped and some in-scope sites are missing from items. Always false for a stored date.

live_capinteger required

How many sites the live 'today so far' view computes before it stops and sets live_partial. Reported on every response, stored dates included, so a client can say 'showing the first N' without hardcoding the number.

viewstring required

'customer' when the caller is a customer-side login (account manager / location manager) and the facts are projected, 'internal' otherwise.

Example response

{
  "date": "2026-09-05",
  "live_cap": 50,
  "view": "internal",
  "items": [
    {
      "site_id": "3f1e0d2c-1111-4222-8333-444455556666",
      "site_name": "Northgate Yard",
      "parent_id": "a1b2c3d4-1111-4222-8333-444455556666",
      "parent_name": "Pioneer Security",
      "account_name": "Jerry Seiner Group",
      "account_name_at_generation": "Jerry Seiner Group",
      "local_date": "2026-09-05",
      "stored": true,
      "id": "9f8e7d6c-1111-4222-8333-444455556666",
      "narrative_source": "llm",
      "counts": {
        "cameras": 12,
        "motion": 143
      },
      "escalations": [],
      "escalation_count": 2,
      "outage_count": 1,
      "email_enabled": true
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.