---
id: "grade_span"
kind: "datatype"
status: "draft"
is_pii: false
name: "Grade span of a school (K-5, 9-12)"
regexp: "^(?:PK|Pre-?K|TK|KG|K|0?[1-9]|1[0-2]) ?[-–] ?(?:PK|KG|K|0?[1-9]|1[0-2])$"
categories: ["education"]
country: ["US"]
langs: ["en"]
quality: 90
url: "https://registry.apicrafter.io/datatype/grade_span"
---

# Grade span of a school (K-5, 9-12) (`grade_span`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

The range of grades a school in the United States teaches, from the lowest to the highest: K-5 for an elementary school, 6-8 for a middle school, 9-12 for a high school, PK-8 or K-12 for others; PK is pre-kindergarten and K or KG kindergarten. School directories and the school sections of real estate listings give it in a column named Grades or Grade Span. A range of digits alone is also a score, so it is matched by the field name; a span that starts with a kindergarten grade is matched by its value too.

- Personal data (PII): no
- Categories: Education (education)
- Countries: United States (US)
- Languages: English (en)
- Classification: categorical

## Detection

Regular expression (Python `re`):

```
^(?:PK|Pre-?K|TK|KG|K|0?[1-9]|1[0-2]) ?[-–] ?(?:PK|KG|K|0?[1-9]|1[0-2])$
```

## Examples

- `K-5` — elementary school
- `6-8` — middle school
- `9-12` — high school
- `PK - 08`
- `A-F` (invalid example)

## Metacrafter rules

2 rules: 1 match the field name, 1 match values.

- `gradespanbyname` (field, `common/education.yaml`)
- `gradespanvalue` (data, `common/education.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- ru: Диапазон классов школы (K-5, 9-12)

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/K%E2%80%9312>
- other: <https://nces.ed.gov/ccd/>

## Quality

Score 90/100. Missing: mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/grade_span.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/US/education/grade_span.yaml>
