---
title: "Read one immutable assessment bound to the current organization and AWS grant"
method: GET
path: "/aws/commerce/history/assessments/{assessmentId}"
---

# Read one immutable assessment bound to the current organization and AWS grant

`GET /aws/commerce/history/assessments/{assessmentId}`

## Request

- Base URL: `https://commerce.decionis.com`
- URL: `https://commerce.decionis.com/aws/commerce/history/assessments/{assessmentId}`
- Auth: HTTP bearer

Requires deployed, enabled AWS historical routes. Every read rechecks the current license, credential revocation and expiry. No organization query argument is accepted. Results contain minimized unsigned historical evidence, not live transaction payloads or execution authority. At most 100 KiB.

## Path parameters

- `assessmentId` string, uuid, required

## Response `200`

Exact stored assessment, including its original source and 90-day window

- HistoricalAssessment
  - `assessment_id` string, uuid, required
  - `status` 'completed' | 'failed', required
  - `mode` 'historical_only', required: Scope of this assessment feature, not the broader products or APIs.
  - `cost_scope` 'merchandise_margin', required: Merchandise subtotal minus discount and reported item cost; shipping, tax and payment/platform fees excluded.
  - `window` object, required
    - `days` 90, required
    - `start` string, date-time, required: Inclusive UTC transaction-time lower bound.
    - `end` string, date-time, required: Exclusive captured UTC end; exactly 90 days after start.
    - `timestamp_field` 'transaction_at', required
  - `provenance` union, required
    - object
      - `kind` 'synthetic', required
      - `label` 'Synthetic commerce history', required
      - `dataset_version` 'commerce-history-v1', required
    - object
      - `kind` 'connected_store', required
      - `label` 'Connected Adobe Commerce history', required
      - `connection_id` string, uuid, required
      - `platform` 'adobe-commerce', required
  - `policy` object, nullable, required
    - `kind` 'sample' | 'merchant', required
    - `version` string, required
    - `floor_percent` number, required
  - `summary` object, required
    - `transactions_scanned` integer, required
    - `evaluated` integer, required
    - `missing_cost` integer, required
    - `excluded_timestamp` integer, required
    - `evaluation_errors` integer, required
    - `allow` integer, required
    - `hold` integer, required
    - `escalate` integer, required
  - `evidence` object[], required
    - `record_id` string, required
    - `transaction_at` string, date-time, required
    - `decision` 'PROCEED' | 'HOLD' | 'ESCALATE', required: Retrospective rule result only; never permission to execute.
    - `reason_codes` string[], required
    - `proof_ref` unknown, required
  - `coverage` object, required
    - `record_limit` 100, required
    - `complete` boolean, required: False for truncation
  - `truncated` boolean, required
  - `error_code` 'CONNECTED_STORE_REQUIRED' | 'HISTORICAL_POLICY_REQUIRED' | 'HISTORICAL_SOURCE_UNAVAILABLE'

## Other responses

- `400`: Stable, non-sensitive historical API error
- `401`: Stable, non-sensitive historical API error
- `403`: Stable, non-sensitive historical API error
- `404`: Stable, non-sensitive historical API error
- `429`: Rate limited; starts allow three requests per minute per licensed organization and grant
- `503`: Stable, non-sensitive historical API error

---

[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)