---
title: "List what Commerce Gate observed and is still open"
method: GET
path: "/v1/commerce/mcp/agent/observations"
---

# List what Commerce Gate observed and is still open

`GET /v1/commerce/mcp/agent/observations`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/commerce/mcp/agent/observations`
- Auth: HTTP bearer

The organization's open drift findings, most recently seen first, at most 50 with truncation explicit: Walmart listings below the margin floor and Business Central payment drift. Each names its function pack and carries its latest detail as at most twenty name and value pairs. The agent proposes from these facts; reading them evaluates, records and executes nothing.

## Response `200`

Validated bounded response; private, no-store

- ObservationList
  - `version` 'commerce-agent-run-v1', required
  - `org_id` string, uuid, required
  - `source` 'drift_ledger' | 'none', required
  - `observations` object[], required
    - `id` string, uuid, required
    - `source` string, required
    - `kind` string, required
    - `subject` string, required
    - `pack` 'merchandising' | 'order-ops' | 'finance-ops' | 'other', required
    - `first_seen_at` string, date-time, required
    - `last_seen_at` string, date-time, required
    - `occurrences` integer, required
    - `facts` object[], required
      - `name` string, required
      - `value` string, required
    - `dossier_id` string
  - `coverage` object, required
    - `limit` unknown, required
    - `truncated` boolean, required
  - `execution_available` unknown, required

## Other responses

- `400`: Malformed, unconfirmed, mismatched or dossier-less PROCEED input
- `401`: Missing or invalid credential
- `403`: Write scope, role or dossier access denied
- `404`: Feature disabled, run or dossier unavailable to this organization
- `409`: Rebound idempotency key or dossier mismatch; never automatically retry a write
- `413`: Request exceeds route byte limit
- `429`: Durable identity/IP limit exceeded; Retry-After supplied
- `503`: Authority, storage or evidence unavailable; completion may be unconfirmed

---

[API](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/revisions/9fecb7109bf8?raw)