---
title: "List all frequency schemas"
method: GET
path: "/v1/frequencies"
tags: ["v1", "Frequency Schemas"]
---

# List all frequency schemas

`GET /v1/frequencies`

Returns all built-in frequency schemas with their field definitions and operational configuration. Use the schema_id or a shorthand alias when adding or searching memories with holographic embedding enabled.

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- FrequencySchemaListResponse — Response for listing all frequency schemas.
  - `success` boolean
  - `schemas` FrequencySchemaResponse[], required
    - `schema_id` string, required — Unique schema ID (domain:name:version)
    - `name` string, required — Schema name
    - `domain` string, required — Domain (e.g. code_search, biomedical)
    - `version` string, required — Schema version
    - `description` string — Human-readable description
    - `num_frequencies` integer, required — Number of frequency bands
    - `frequencies` FrequencyFieldResponse[], required — Frequency band definitions
      - `frequency_hz` number, required — Frequency in Hz (brain-inspired band)
      - `name` string, required — Field name extracted at this frequency
      - `type` string, required — Field type: ENUM, FREE_TEXT, NUMERIC, DATE, MULTI_VALUE
      - `description` string — Human-readable field description
      - `weight` number — Default weight for this frequency band
    - `config` SchemaConfigResponse, required — Operational configuration for a frequency schema.
      - `dspy_model_path` string, nullable — Path to DSPy-optimized extractor model (null = use direct LLM)
      - `llm_metadata_model` string — LLM model for metadata extraction
      - `weight_mode` string — Frequency weight mode (legacy_sparse, code_search_v2, hybrid_optimized_v2)
      - `contrast_gamma` number — Contrast enhancement gamma
      - `use_sparse_weights` boolean — Enable sparse frequency weights
      - `use_complex_interference` boolean — Enable complex interference scoring (PDCI, SFI)
      - `use_adaptive_weights` boolean — Enable query-adaptive frequency weights
      - `cross_encoder_model` string — Cross-encoder reranking model
      - `cross_encoder_topk` integer — Number of candidates for cross-encoder reranking
      - `qdrant_topk` integer — Over-fetch count from Qdrant for reranking
      - `enable_entailment_rerank` boolean — Enable entailment-gated reranking (EGR)
      - `default_scoring_method` string — Default scoring method for this schema
  - `total` integer, required
  - `shortcuts` object — Shorthand aliases (e.g. 'cosqa' -> 'code_search:cosqa:2.0.0')

## Other responses

- `422` — Validation Error

## Changes

- **2026-06-11** `c81ae5036e69` — 1 info
  - endpoint added
- **2026-06-10** `be9f8810bed0` — 1 breaking
  - api path removed without deprecation
- **2026-06-10** `02daa1da4e82` — 1 info
  - endpoint added
- **2026-06-01** `56af15e4d864` — 1 breaking
  - api path removed without deprecation
- **2026-03-13** `0e4854909d2a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/papr-ai/apis/papr-memory-api/changes/v1/frequencies/get.md)

---

[API](https://skmtc.dev/papr-ai/apis/papr-memory-api.md) · [All operations](https://skmtc.dev/papr-ai/apis/papr-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/papr-ai/apis/papr-memory-api/revisions/02daa1da4e82?raw)