Lists the stored observation receipts that name one catalog entity, one item per distinct receipt in ascending receipt order, in pages of at most 25 (?limit 1..25, ?cursor from the previous page): each item carries the receipt id, the event type, the registration snapshot recorded at reception (historical, not the source's current registration or health), the source-declared occurrence instant when declared, first and last reception of the same retained facts, the equal-facts delivery count and whether a conflicting redelivery is retained; names, references, labels, raw facts, hashes and event ids are withheld, a missing catalog entry is 404, and an empty page does not prove no observation.
const url = 'https://example.com/v1/m/inventory/entities/example/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/observations?limit=25';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/v1/m/inventory/entities/example/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/observations?limit=25' \ --header 'Authorization: Bearer <token>'Lists the stored observation receipts that name one catalog entity, one item per distinct receipt in ascending receipt order, in pages of at most 25 (?limit 1..25, ?cursor from the previous page): each item carries the receipt id, the event type, the registration snapshot recorded at reception (historical, not the source’s current registration or health), the source-declared occurrence instant when declared, first and last reception of the same retained facts, the equal-facts delivery count and whether a conflicting redelivery is retained; names, references, labels, raw facts, hashes and event ids are withheld, a missing catalog entry is 404, and an empty page does not prove no observation.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”Path parameter kind.
Canonical lowercase nonzero UUID.
The catalog entity’s core id as a canonical lowercase nonzero UUID; any other spelling is 400 before a row is read. The exact (kind, id) pair must exist in the tenant’s catalog, or the answer is 404.
Header Parameters
Section titled “ Header Parameters ”Target tenant id; required when the principal can act in more than one tenant.
Query Parameters
Section titled “ Query Parameters ”Page size in distinct receipts, 1 through 25; 25 when absent. Canonical decimal only and at most once: a repeated, empty, non-decimal or out-of-range value is 400.
Canonical lowercase nonzero receipt id.
Exclusive keyset anchor, at most once: the cursor returned with the previous page, which is the receipt id of its last item; the page starts strictly after it in ascending receipt-id order. A canonical lowercase nonzero UUID; any other form, an empty value or a repeated cursor is 400.
Responses
Section titled “ Responses ”One page of the entity’s observation history. Every receipt on the page was validated against the writer’s own encoding before any item was published: the page is whole, or it is refused with 500.
object
The receipt id of the last item, present only when has_more is true; pass it as ?cursor to continue strictly after it.
True when at least one more distinct matching receipt id exists past this page. It certifies nothing about that receipt’s integrity: the page that composes it decides, and a lookahead is not a certificate.
One item per distinct receipt that names the entity, ascending by receipt id. Empty when the tenant stores no receipt for the entity, which does not prove it was never observed.
object
Whether at least one redelivery of this receipt carried DIFFERENT facts and was retained separately. A boolean by design: the conflicting facts, their count and their times are not published.
Deliveries of the receipt with equal facts: the original plus exact replays. Not distinct activity, and conflicting variants are excluded.
The first-party observation type the receipt recorded.
This platform’s reception clock for the original delivery of the retained facts.
This platform’s reception clock for the last delivery that carried facts equal to the retained ones. A conflicting redelivery has its own counters and is not folded in.
The platform receipt id. One item per receipt: a receipt whose members name this entity twice is still one item.
object
The persistent local execution environment the snapshot recorded; not a host and not a workspace.
The receipt recorded a complete registration snapshot when it was received.
Persistent id of the roster row the snapshot named. A historical identifier, not a grant to read that row.
The roster revision the snapshot says was applied when the observation was produced; not the roster’s current revision.
object
No registration snapshot was stamped on the observation.
object
A snapshot was stamped but it was incomplete; its partial components are not published.
The instant the SOURCE declared for the fact, taken from the validated member that names this entity; the same claim that feeds the catalog entry’s occurred_at. Omitted when the source declared none.
Example
{ "items": [ { "event_type": "edge.observed", "registration": { "registration_state": "registered_snapshot" } } ]}Bad request
object
Example generated
{}Unauthenticated
object
Example generated
{}Forbidden
object
Example generated
{}Not found
object
Example generated
{}Conflict / setup required
object
Example generated
{}Rate limited
object
Example generated
{}Stored observation evidence failed an integrity invariant, or the member repository cannot project distinct receipts; the body is the generic error and the reason goes to the operator log, never to the client
object
Example generated
{}