Skip to main content
Summarize cached messages
Use this authenticated endpoint to poll a Cache. The response contains message IDs and, for chunks, group ID and sequence metadata. It does not contain encrypted envelopes, plaintext, or retrieval proofs. The Cache includes only active messages and complete assured chunk sets, using the same visibility rules as GET /cache/messages/{did}. For a device queue, use GET /cache/summary/{did}/{deviceId} or supply X-Device-Id. Count each message_id once across multiple Cache endpoints to avoid counting replicated messages twice. Group entries by message_group_id to count complete payloads rather than chunks. Sign the standard Cache retrieval proof with operation summary and subject *:
Send the signature as Base64 in X-Signature, with the other proof fields in X-Recipient-DID, X-Device-Id, X-Service-Id, X-Cache-Endpoint, X-Key-Id, X-Timestamp, and X-Nonce. The signing method must be listed in the DID’s OpenPayloadCacheService.authorization and, when present, authentication. The signed cache_endpoint must be identical to the X-Cache-Endpoint value. For authorization, HTTPS URLs with and without :443 are equivalent, as are base URLs with and without a trailing slash. A nonstandard port remains distinct.
200 Response
count is the number of message entries on this Cache, not a count across replicas. Reading this endpoint does not acknowledge or remove messages.