Assess a bounded previous-90-day history without executing commerce actions

Additive historical feature; it does not replace the existing governance APIs. Requires deployed, enabled AWS historical routes and a current licensed credential. The server fixes the previous 90-day window by transaction time. Accepts only a supported connected-store UUID or the labelled synthetic dataset, never raw transactions, organization, dates or a policy override. Reusing a request key returns the immutable original result; rebinding its source returns 409. Responses are at most 100 KiB, with at most 100 records assessed. Partial history, missing item costs and timestamp gaps remain visible. Results measure merchandise margin only, excluding shipping, taxes and payment or platform fees. Inline results are unsigned, with null proof_ref; no signed dossier is claimed. Synthetic examples use an explicit sample 12 percent floor, never a guessed customer policy. A verified 14-day AWS trial uses its actual entitlement expiry; this endpoint never starts or extends a trial. No platform or AWS usage write.

post/aws/commerce/history/assessments

Request

  • Base URL: https://commerce.decionis.com
  • URL: https://commerce.decionis.com/aws/commerce/history/assessments
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

If supplied, must equal the required body idempotency_key.

Request body

idempotency_keystring required

Response

Immutable completed or failed assessment; failures contain stable error codes

assessment_idstring 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.

truncatedboolean required
error_code'CONNECTED_STORE_REQUIRED' | 'HISTORICAL_POLICY_REQUIRED' | 'HISTORICAL_SOURCE_UNAVAILABLE'

Changes

No recorded changes to this operation across all 1 revision of this API.