---
title: "Inspect the selected Commerce Gate policy configuration"
method: GET
path: "/v1/protocol/policies/commerce/readiness"
---

# Inspect the selected Commerce Gate policy configuration

`GET /v1/protocol/policies/commerce/readiness`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/protocol/policies/commerce/readiness`
- Auth: HTTP bearer

Source candidate requiring the matching backend. Requires VIEWER access and policy:read, policy:* or org:* scope for the requested organization. Unknown or duplicate query fields are rejected. Reports configuration only; HTTP 200 does not approve an action, activate policy or prove connector or release readiness. Responses are private and must not be cached.

## Query parameters

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

## Response `200`

Configuration report, including missing, unsupported or unavailable states

- CommercePreflightReadiness
  - `version` 'commerce-preflight-readiness-v1', required
  - `org_id` string, uuid, required
  - `checked_at` string, date-time, required
  - `preflight_version` 'commerce-preflight-v2', required
  - `evaluator_version` 'policy-graph/1.1+commerce-preflight/2.0', required
  - `policy_resolution` object, required
    - `requested_policy_version` string, nullable, required
    - `resolved_policy_version` string, nullable, required
    - `status` 'exact_match' | 'newest_active' | 'requested_not_found' | 'policy_guard', required
  - `selected_policy` object, nullable, required
    - `bundle_id` string, uuid, required
    - `version` string, required
    - `effective_from` string, date-time, nullable, required
    - `effective_to` string, date-time, nullable, required
    - `rules_sha256` string, required
    - `parameters_sha256` string, required
    - `commerce_preflight_digest` string, nullable, required
  - `configuration` object, nullable, required
    - `version` 'commerce-preflight-v2', required
    - `max_fact_age_seconds` integer, required
    - `allowed_sources` string[], required
    - `checks` object, required
      - `P01` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `floor_percent` number, required
      - `P02` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `tolerance_percent` number, required
      - `P03` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `minimum_available` integer, required
      - `P04` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `mode` 'allow' | 'block', required
          - `countries` string[], required
      - `P05` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `max_concurrent_discounts` integer, required
      - `P06` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `tolerance_percent` number, required
      - `P07` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `max_redemptions` integer, required
          - `new_account_age_days` number, required
      - `P08` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
      - `P09` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `amount` number, required
          - `currency` string, required
      - `P10` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `max_prior_refunds` integer, required
      - `P11` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `return_window_days` integer, required
      - `P12` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `unattended_limit` object, required
            - `amount` number, required
            - `currency` string, required
      - `P13` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
      - `P14` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `window_days` integer, required
      - `P15` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `floor` object, required
            - `amount` number, required
            - `currency` string, required
      - `P16` union
        - object
          - `enabled` false, required
        - object
          - `enabled` true, required
          - `minimum_annualized_yield_percent` number, required
  - `checks` object[], required
    - `id` 'P01' | 'P02' | 'P03' | 'P04' | 'P05' | 'P06' | 'P07' | 'P08' | 'P09' | 'P10' | 'P11' | 'P12' | 'P13' | 'P14' | 'P15' | 'P16', required
    - `status` 'enabled' | 'disabled' | 'missing' | 'unsupported' | 'unavailable', required
  - `counts` object, required
    - `enabled` integer, required
    - `disabled` integer, required
    - `missing` integer, required
    - `unsupported` integer, required
    - `unavailable` integer, required
  - `configuration_complete` boolean, required
  - `all_disabled` boolean, required
  - `diagnostics` object[], required
    - `code` 'MISSING_ORG_POLICY_BUNDLE' | 'NO_ACTIVE_ORG_POLICY_BUNDLE' | 'REQUESTED_POLICY_BUNDLE_NOT_FOUND' | 'COMMERCE_POLICY_MISSING' | 'COMMERCE_POLICY_UNSUPPORTED' | 'CHECK_POLICY_MISSING' | 'ALL_CHECKS_DISABLED', required
    - `path` string, required

## Other responses

- `400`: Invalid or duplicate query fields
- `401`: Authentication required
- `403`: Organization, role or policy-read scope denied
- `502`: Policy service unavailable or returned an invalid or mismatched report

---

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