---
title: "Search standards"
method: GET
path: "/academic-standards/search"
tags: ["Academic Standards", "Search"]
---

# Search standards

`GET /academic-standards/search`

Searches for StandardsFrameworkItems using either semantic search or exact statement code match across all standards frameworks.

This endpoint supports two mutually exclusive search modes:

- **Semantic search** (`query`): Full-text semantic search against the standard's description. Results are ranked by relevance and include a `score` reflecting vector similarity.
- **Code search** (`statementCode`): Exact statement code match (e.g., "3.NF.A.1"). Case-insensitive, no partial matching. All results carry a `score` of 1.0.

**Exactly one of `query` or `statementCode` must be provided.** Providing both or neither returns a 400 error.

Results can be narrowed further using the optional filters and support cursor-based pagination.

Use this endpoint when you need to:
- Find academic standards relevant to a concept or learning goal (semantic search)
- Look up an academic standard by its exact statement code
- Find all standards frameworks that include a specific statement code
- Filter search results by grade level, subject, or statement type

**Note:** Not all academic standards have statement codes - some organizational groupings may have null codes and won't appear in code search results.

**Related topics:**
- [Understanding statement codes](/knowledge-graph/graph-reference/academic-standards#standardsframeworkitem)

## Query parameters

- `query` string
- `statementCode` string
- `gradeLevel` GradeLevelENUM[]
- `academicSubject` 'English Language Arts' | 'Mathematics' | 'Science' | 'Social Studies' | 'Other' — Academic subject area
- `normalizedStatementType` 'Standard' | 'Standard Grouping' | 'Other' — Classification label that has been standardized across standards frameworks for cross-state queries and categorization
- `jurisdiction` 'Alabama' | 'Alaska' | 'Arizona' | 'Arkansas' | 'California' | 'Colorado' | 'Connecticut' | 'Delaware' | 'Florida' | 'Georgia' | 'Hawaii' | 'Idaho' | 'Illinois' | 'Indiana' | 'Iowa' | 'Kansas' | 'Kentucky' | 'Louisiana' | 'Maine' | 'Maryland' | 'Massachusetts' | 'Michigan' | 'Minnesota' | 'Mississippi' | 'Missouri' | 'Montana' | 'Nebraska' | 'Nevada' | 'New Hampshire' | 'New Jersey' | 'New Mexico' | 'New York' | 'North Carolina' | 'North Dakota' | 'Ohio' | 'Oklahoma' | 'Oregon' | 'Pennsylvania' | 'Rhode Island' | 'South Carolina' | 'South Dakota' | 'Tennessee' | 'Texas' | 'Utah' | 'Vermont' | 'Virginia' | 'Washington' | 'Washington, D.C.' | 'West Virginia' | 'Wisconsin' | 'Wyoming' | 'Multi-State' — US state, territory, or multi-state designation
- `limit` integer

## Response `200`

Successfully retrieved search results (ranked by relevance)

- AcademicStandardSearchResult[]
  - `caseIdentifierUUID` string, uuid, required — CASE Network UUID for the resource
  - `statementCode` string, nullable — Code that identifies a standard within its standards framework (e.g., "3.NF.A.1", "A.1B", "MP1"); `null` for organizational groupings without assigned codes
  - `description` string, nullable — Full text of the standard describing what students should know or be able to do
  - `jurisdiction` 'Alabama' | 'Alaska' | 'Arizona' | 'Arkansas' | 'California' | 'Colorado' | 'Connecticut' | 'Delaware' | 'Florida' | 'Georgia' | 'Hawaii' | 'Idaho' | 'Illinois' | 'Indiana' | 'Iowa' | 'Kansas' | 'Kentucky' | 'Louisiana' | 'Maine' | 'Maryland' | 'Massachusetts' | 'Michigan' | 'Minnesota' | 'Mississippi' | 'Missouri' | 'Montana' | 'Nebraska' | 'Nevada' | 'New Hampshire' | 'New Jersey' | 'New Mexico' | 'New York' | 'North Carolina' | 'North Dakota' | 'Ohio' | 'Oklahoma' | 'Oregon' | 'Pennsylvania' | 'Rhode Island' | 'South Carolina' | 'South Dakota' | 'Tennessee' | 'Texas' | 'Utah' | 'Vermont' | 'Virginia' | 'Washington' | 'Washington, D.C.' | 'West Virginia' | 'Wisconsin' | 'Wyoming' | 'Multi-State' — US state, territory, or multi-state designation
  - `author` string, required — Author or creator of the resource
  - `provider` string, required — Source data provider for the resource
  - `license` string, uri, required — URL to the resource's license document
  - `attributionStatement` string, required — Statement that acknowledges the resource's author and provider, as required by the CC BY 4.0 license
  - `score` number, float, required — Relevance score between 0 and 1 (reflects vector similarity for semantic search; 1.0 for exact code match)

## Other responses

- `400` — Bad request - exactly one of query or statementCode must be provided
- `422` — Unprocessable Entity - Invalid parameter values (e.g., enum value not in allowed list)
- `500` — Internal server error

---

[API](https://skmtc.dev/learningcommons/apis/learning-commons-knowledge-graph-rest-api.md) · [All operations](https://skmtc.dev/learningcommons/apis/learning-commons-knowledge-graph-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/learningcommons/learning-commons-knowledge-graph-rest-api/revisions/87a44fbb081f/schema)