---
title: "Resolve tenant-scoped rulebook metadata"
method: GET
path: "/api/decision/rulebooks"
tags: ["Registries"]
---

# Resolve tenant-scoped rulebook metadata

`GET /api/decision/rulebooks`

## Request

- Base URL: `https://www.decide.fyi`
- URL: `https://www.decide.fyi/api/decision/rulebooks`
- Auth: API key in header `x-api-key`

Returns metadata for one immutable rulebook snapshot in the authenticated caller scope. Provide hash, or both rulebook_id and version. Registry listing and snapshot-body disclosure are intentionally unsupported.

## Query parameters

- `hash` string
- `rulebook_id` string
- `version` string

## Response `200`

Tenant-scoped immutable rulebook metadata

- object
  - `ok` true, required
  - `rulebook` RulebookRegistryMetadata, required
    - `rulebook_registry_version` 'decision_rulebook_registry_v1', required
    - `schema_version` 'rulebook_v1', required
    - `rulebook_id` string, required
    - `version` string, required
    - `hash` string, required
    - `evaluator_version` string, required
    - `trusted_adapter` TrustedAdapterDependency
      - `manifest_version` 'trusted_adapter_manifest_v1', required
      - `adapter_id` string, required
      - `version` string, required
      - `implementation_revision` string, required
      - `implementation_hash` string, required
      - `manifest_hash` string, required
    - `hash_algorithm` 'sha256', required
    - `canonicalization` 'json.sort_deep.v1', required
    - `scope_hash` string, required
    - `registry_attestation` RegistryAttestation, required
      - `registry_attestation_version` 'decision_registry_attestation_v1', required
      - `status` 'signed' | 'unsigned', required
      - `attestation_hash` string, required
      - `key_id` string
      - `signature_algorithm` 'ed25519'
      - `signature` string
      - `public_key` string
      - `public_key_fingerprint` string
    - `registered_at` string, date-time, required

## Other responses

- `400`: Exact lookup parameters are required
- `401`: API key missing, invalid, inactive, or unauthorized
- `404`: Rulebook metadata not found in caller scope

---

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