find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/decide-fyi:decide-fyi-registries-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Decide Decision Registries API
  summary: Decision protocol for state-changing software actions.
  description: Call Decide before products, agents, queues, billing systems, CRMs, or internal tools change state. The API returns a signed Decision Record v1 object with policy bundle attestation, evidence, action binding, replay, verification handles, portable Decision Packet v1 exports, simulation-only counterfactual analysis, cryptographic audit chains, Action Execution Receipts, Outcome Records, CRM Sync Records, predictive confidence, first-party policy pattern templates, policy effectiveness metrics, opt-in anonymized benchmarks, and explainable anomaly reports derived from reported outcomes.
  version: 1.13.0
  x-decision-protocol-version: decision_protocol_v1
  x-decision-record-version: decision_record_v1
  x-decision-packet-version: decision_packet_v1
servers:
- url: https://www.decide.fyi
  description: Production
security:
- ApiKeyAuth: []
tags:
- name: Registries
  description: Receipt key and policy bundle registries.
paths:
  /api/decision/policy-bundles:
    get:
      tags:
      - Registries
      operationId: listPolicyBundles
      summary: Read the policy bundle registry
      security: []
      parameters:
      - name: hash
        in: query
        required: false
        schema:
          type: string
        description: Optional policy bundle hash to resolve a single bundle.
      responses:
        '200':
          description: Policy bundle registry
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyBundleRegistry'
        '404':
          description: Bundle hash not found
  /api/decision/rulebooks:
    get:
      tags:
      - Registries
      operationId: getRulebookMetadata
      summary: Resolve tenant-scoped rulebook metadata
      description: 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.
      parameters:
      - name: hash
        in: query
        required: false
        schema:
          type: string
      - name: rulebook_id
        in: query
        required: false
        schema:
          type: string
      - name: version
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Tenant-scoped immutable rulebook metadata
          content:
            application/json:
              schema:
                type: object
                required:
                - ok
                - rulebook
                properties:
                  ok:
                    type: boolean
                    const: true
                  rulebook:
                    $ref: '#/components/schemas/RulebookRegistryMetadata'
                additionalProperties: false
        '400':
          description: Exact lookup parameters are required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Rulebook metadata not found in caller scope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/decision/receipt-keys:
    get:
      tags:
      - Registries
      operationId: listReceiptKeys
      summary: Read the public receipt key registry
      security: []
      responses:
        '200':
          description: Receipt key registry
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiptKeyRegistry'
components:
  schemas:
    ReceiptKeyRegistry:
      type: object
      required:
      - ok
      - status
      - keys
      properties:
        ok:
          type: boolean
        status:
          type: string
        current_key_id:
          type:
          - string
          - 'null'
        keys:
          type: array
          items:
            type: object
            properties:
              key_id:
                type: string
              algorithm:
                type: string
              public_key:
                type: string
              public_key_fingerprint:
                type: string
              status:
                type: string
              updated_at:
                type: string
            additionalProperties: true
      additionalProperties: true
    PolicyBundle:
      type: object
      properties:
        id:
          type: string
        version:
          type: string
        hash:
          type: string
        hash_algorithm:
          type: string
          default: sha256
        canonicalization:
          type: string
          default: json.sort_deep.v1
        source:
          type: string
        status:
          type: string
        effective_at:
          type: string
        deprecated_at:
          type: string
        changelog:
          type: string
        content_hash:
          type: string
      additionalProperties: true
    TrustedAdapterDependency:
      type: object
      required:
      - manifest_version
      - adapter_id
      - version
      - implementation_revision
      - implementation_hash
      - manifest_hash
      properties:
        manifest_version:
          type: string
          const: trusted_adapter_manifest_v1
        adapter_id:
          type: string
        version:
          type: string
        implementation_revision:
          type: string
        implementation_hash:
          type: string
          pattern: ^[a-f0-9]{64}$
        manifest_hash:
          type: string
          pattern: ^[a-f0-9]{64}$
      additionalProperties: false
    PolicyBundleRegistry:
      type: object
      required:
      - ok
      - status
      - bundles
      - registry_hash
      properties:
        ok:
          type: boolean
        status:
          type: string
        current_policy_bundle_hash:
          type:
          - string
          - 'null'
        current:
          $ref: '#/components/schemas/PolicyBundle'
        bundles:
          type: array
          items:
            $ref: '#/components/schemas/PolicyBundle'
        registry_hash:
          type: string
      additionalProperties: true
    RulebookRegistryMetadata:
      type: object
      required:
      - rulebook_registry_version
      - schema_version
      - rulebook_id
      - version
      - hash
      - evaluator_version
      - hash_algorithm
      - canonicalization
      - scope_hash
      - registry_attestation
      - registered_at
      properties:
        rulebook_registry_version:
          type: string
          const: decision_rulebook_registry_v1
        schema_version:
          type: string
          const: rulebook_v1
        rulebook_id:
          type: string
        version:
          type: string
        hash:
          type: string
          minLength: 64
          maxLength: 64
        evaluator_version:
          type: string
        trusted_adapter:
          $ref: '#/components/schemas/TrustedAdapterDependency'
        hash_algorithm:
          type: string
          const: sha256
        canonicalization:
          type: string
          const: json.sort_deep.v1
        scope_hash:
          type: string
          pattern: ^[a-f0-9]{64}$
        registry_attestation:
          $ref: '#/components/schemas/RegistryAttestation'
        registered_at:
          type: string
          format: date-time
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        c:
          type: string
        v:
          type: string
        request_id:
          type: string
        error:
          type: string
        message:
          type: string
      additionalProperties: true
    RegistryAttestation:
      type: object
      required:
      - registry_attestation_version
      - status
      - attestation_hash
      properties:
        registry_attestation_version:
          type: string
          const: decision_registry_attestation_v1
        status:
          type: string
          enum:
          - signed
          - unsigned
        attestation_hash:
          type: string
          pattern: ^[a-f0-9]{64}$
        key_id:
          type: string
        signature_algorithm:
          type: string
          const: ed25519
        signature:
          type: string
          pattern: '^ed25519:'
        public_key:
          type: string
        public_key_fingerprint:
          type: string
          pattern: ^[a-f0-9]{64}$
      additionalProperties: false
  responses:
    Unauthorized:
      description: API key missing, invalid, inactive, or unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key