---
title: "Get a frequency schema by ID or shorthand"
method: GET
path: "/v1/frequencies/{frequency_schema_id}"
tags: ["v1", "Frequency Schemas"]
---

# Get a frequency schema by ID or shorthand

`GET /v1/frequencies/{frequency_schema_id}`

Retrieve a specific frequency schema by its full ID (e.g. 'code_search:cosqa:2.0.0') or shorthand alias (e.g. 'cosqa').

## Path parameters

- `frequency_schema_id` string, required

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- FrequencySchemaResponse — Full frequency schema with fields and config.
  - `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

## Other responses

- `422` — Validation Error

## Changes

- **2026-06-11** `f29d29d1ad16` — 1 info
  - endpoint added
- **2026-06-11** `22d84aa060d6` — 1 breaking
  - api path removed without deprecation
- **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

[Full history](https://skmtc.dev/papr-ai/apis/papr-memory-api/changes/v1/frequencies/:frequency_schema_id/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/f29d29d1ad16?raw)