---
title: "Read the policy pattern registry"
method: GET
path: "/api/decision/policy-patterns"
tags: ["Policy Patterns"]
---

# Read the policy pattern registry

`GET /api/decision/policy-patterns`

## Request

- Base URL: `https://www.decide.fyi`
- URL: `https://www.decide.fyi/api/decision/policy-patterns`
- Auth: none required

Returns first-party Decision API pattern templates. Pass pattern_id for a single pattern or tag to filter the registry.

## Query parameters

- `pattern_id` string
- `tag` string

## Response `200`

Policy pattern registry or single policy pattern

- union
  - DecisionPatternRegistry
    - `ok` boolean, required
    - `decision_protocol_version` string
    - `decision_record_version` string
    - `decision_pattern_registry_version` 'decision_pattern_registry_v1', required
    - `source` string
    - `status` string
    - `count` integer
    - `patterns` DecisionPattern[], required
      - `decision_pattern_version` 'decision_pattern_v1', required
      - `pattern_id` string, required
      - `name` string
      - `version` string
      - `category` string
      - `status` string
      - `summary` string
      - `policy_id` string, required
      - `recommended_policy_version` string
      - `source` string
      - `tags` string[]
      - `required_context_fields` string[]
      - `recommended_context_fields` string[]
      - `evidence_codes` string[]
      - `decision_request_template` union
        - object
          - `question` string, required
          - `mode` 'single' | 'multi' | 'runtime' | 'rulebook'
          - `prompt` string
          - `stem` string
          - `options` string[]
          - `context` union
            - object
            - string
          - `response_view` 'minimal' | 'standard' | 'full'
          - `rulebook` RulebookV1
            - `schema_version` 'rulebook_v1', required
            - `rulebook_id` string, required
            - `version` string, required
            - `input_schema` RulebookInputSchema
              - …
            - `rules` RulebookRule[], required
              - …
            - `default_outcome` RulebookOutcome, required
              - …
          - `adapter` TrustedAdapterInvocation
            - `adapter_id` string, required
            - `version` string, required
            - `manifest_hash` string, required
            - `input` object, required
        - object
          - `question` string
          - `mode` 'single' | 'multi' | 'runtime' | 'rulebook'
          - `prompt` string, required
          - `stem` string
          - `options` string[]
          - `context` union, required
            - object
            - string
          - `response_view` 'minimal' | 'standard' | 'full'
          - `rulebook` RulebookV1
            - `schema_version` 'rulebook_v1', required
            - `rulebook_id` string, required
            - `version` string, required
            - `input_schema` RulebookInputSchema
              - …
            - `rules` RulebookRule[], required
              - …
            - `default_outcome` RulebookOutcome, required
              - …
          - `adapter` TrustedAdapterInvocation
            - `adapter_id` string, required
            - `version` string, required
            - `manifest_hash` string, required
            - `input` object, required
        - object
          - `mode` 'rulebook', required
          - `question` string
          - `prompt` string
          - `stem` string
          - `options` string[]
          - `context` union, required
            - object
            - string
          - `response_view` 'minimal' | 'standard' | 'full'
          - `rulebook` RulebookV1, required
            - `schema_version` 'rulebook_v1', required
            - `rulebook_id` string, required
            - `version` string, required
            - `input_schema` RulebookInputSchema
              - …
            - `rules` RulebookRule[], required
              - …
            - `default_outcome` RulebookOutcome, required
              - …
          - `adapter` TrustedAdapterInvocation
            - `adapter_id` string, required
            - `version` string, required
            - `manifest_hash` string, required
            - `input` object, required
      - `outcome_template` object
      - `crm_sync_template` object
      - `sdk_examples` string[]
      - `pattern_hash` string, required
    - `registry_hash` string, required
    - `endpoints` object
  - DecisionPatternResponse
    - `ok` boolean, required
    - `policy_pattern` DecisionPattern, required
      - `decision_pattern_version` 'decision_pattern_v1', required
      - `pattern_id` string, required
      - `name` string
      - `version` string
      - `category` string
      - `status` string
      - `summary` string
      - `policy_id` string, required
      - `recommended_policy_version` string
      - `source` string
      - `tags` string[]
      - `required_context_fields` string[]
      - `recommended_context_fields` string[]
      - `evidence_codes` string[]
      - `decision_request_template` union
        - object
          - `question` string, required
          - `mode` 'single' | 'multi' | 'runtime' | 'rulebook'
          - `prompt` string
          - `stem` string
          - `options` string[]
          - `context` union
            - object
            - string
          - `response_view` 'minimal' | 'standard' | 'full'
          - `rulebook` RulebookV1
            - `schema_version` 'rulebook_v1', required
            - `rulebook_id` string, required
            - `version` string, required
            - `input_schema` RulebookInputSchema
              - …
            - `rules` RulebookRule[], required
              - …
            - `default_outcome` RulebookOutcome, required
              - …
          - `adapter` TrustedAdapterInvocation
            - `adapter_id` string, required
            - `version` string, required
            - `manifest_hash` string, required
            - `input` object, required
        - object
          - `question` string
          - `mode` 'single' | 'multi' | 'runtime' | 'rulebook'
          - `prompt` string, required
          - `stem` string
          - `options` string[]
          - `context` union, required
            - object
            - string
          - `response_view` 'minimal' | 'standard' | 'full'
          - `rulebook` RulebookV1
            - `schema_version` 'rulebook_v1', required
            - `rulebook_id` string, required
            - `version` string, required
            - `input_schema` RulebookInputSchema
              - …
            - `rules` RulebookRule[], required
              - …
            - `default_outcome` RulebookOutcome, required
              - …
          - `adapter` TrustedAdapterInvocation
            - `adapter_id` string, required
            - `version` string, required
            - `manifest_hash` string, required
            - `input` object, required
        - object
          - `mode` 'rulebook', required
          - `question` string
          - `prompt` string
          - `stem` string
          - `options` string[]
          - `context` union, required
            - object
            - string
          - `response_view` 'minimal' | 'standard' | 'full'
          - `rulebook` RulebookV1, required
            - `schema_version` 'rulebook_v1', required
            - `rulebook_id` string, required
            - `version` string, required
            - `input_schema` RulebookInputSchema
              - …
            - `rules` RulebookRule[], required
              - …
            - `default_outcome` RulebookOutcome, required
              - …
          - `adapter` TrustedAdapterInvocation
            - `adapter_id` string, required
            - `version` string, required
            - `manifest_hash` string, required
            - `input` object, required
      - `outcome_template` object
      - `crm_sync_template` object
      - `sdk_examples` string[]
      - `pattern_hash` string, required

## Other responses

- `404`: Pattern not found

---

[API](https://skmtc.dev/decide/apis/decide-decision-api.md) · [All operations](https://skmtc.dev/decide/apis/decide-decision-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decide/apis/decide-decision-api/revisions/caf1d3069dfd?raw)