---
title: "Read the exact current historical comparison policy"
method: GET
path: "/v1/internal/commerce/connected/history/policy"
---

# Read the exact current historical comparison policy

`GET /v1/internal/commerce/connected/history/policy`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/internal/commerce/connected/history/policy`
- Auth: HTTP bearer

Default off; only a dedicated commerceConnectedTransport credential is admitted. Enabled automatic onboarding additionally requires accountSourceAuthority:true with orgIds omitted. This is not a generic wildcard org key. Each handler independently verifies fresh Accounts signed authority, exact resource/source/plan/tenant/revision and the synced projection before disclosing any result. Generic fixed-orgIds service keys keep their existing permissions. Requires the transient source proof header, at least one approved Walmart or Adobe source and an explicit nonzero or null history allowance. Reads the selected exact version; never chooses a default or writes policy.

## Query parameters

- `org_id` string, uuid, required
- `policy_version` string, required

## Headers

- `x-org-id` string, uuid, required
- `x-commerce-source-authority` string, required

## Response `200`

Bounded private result

- object
  - `org_id` string, uuid, required
  - `policy` CommerceMarketplaceHistoryPolicy, required
    - `bundle_id` string, uuid, required
    - `version` string, required
    - `policy_digest` string, required
    - `floor_percent` number, required
    - `max_concurrent_discounts` integer, required
    - `price_tolerance_percent` number, required
    - `price_reference` object
      - `kind` 'recorded_order_original_price', required
      - `max_markdown_percent` number, required
    - `comparison` 'observed_historical_commerce_checks', required
    - `full_policy_evaluated` false, required

## Other responses

- `400`: Invalid, oversized or conflicting request fields
- `401`: Authentication required
- `403`: Current signed authority, source, scope, role or company permission denied
- `404`: Authorized source, document or evidence unavailable
- `409`: Exact source, policy, evidence or idempotency binding changed; an uncertain write is never retried
- `429`: Request rate limit reached
- `503`: Default-off capability or required dependency unavailable

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)