Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 3,
"maxLength": 120,
"description": "The family's own words for what they want that the filters can't say — a program or approach ('Spanish dual language', 'Montessori', 'strong music program', 'robotics'). Ranks the matches best first, each with the line it matched on (match_reason). Anything passed as a filter is already applied; a school's name goes to find-school, and ratings aren't searchable text."
},
"borough": {
"type": "string",
"enum": [
"Manhattan",
"Brooklyn",
"Queens",
"Bronx",
"Staten Island"
],
"description": "Limit to one borough. Omit unless the family named one."
},
"district": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 32
},
"minItems": 1,
"maxItems": 8,
"description": "Community school district numbers, 1-32. A borough is NOT a district — for 'schools in the Bronx' use `borough` and omit this. A district the family didn't name filters out every other one."
},
"grade_band": {
"type": "string",
"enum": [
"prek",
"elementary",
"middle",
"high"
],
"description": "prek (K-12 schools that also run 3-K/pre-K), elementary (K-5), middle (6-8), high (9-12)"
},
"governance": {
"type": "array",
"items": {
"type": "string",
"enum": [
"public",
"charter",
"private"
]
},
"minItems": 1,
"maxItems": 3,
"description": "School type. Omit unless the family named one."
},
"admissions_method": {
"type": "array",
"items": {
"type": "string",
"enum": [
"zoned",
"zone_priority",
"unscreened",
"limited_unscreened",
"screened",
"language_criteria",
"ed_opt",
"audition",
"shsat",
"charter_lottery",
"private_admissions",
"prek_universal"
]
},
"minItems": 1,
"maxItems": 10,
"description": "How the school admits students; matches a school admitting by ANY listed method. Call get-admissions-methods or explain-admissions-method for what each one means."
},
"program_categories": {
"type": "array",
"items": {
"type": "string",
"enum": [
"academic",
"arts",
"sports",
"stem",
"language",
"extracurricular"
]
},
"minItems": 1,
"maxItems": 6,
"description": "Program focus; matches a school offering ANY listed focus. 'arts' covers art, music, dance, drama and theater; 'extracurricular' means clubs. Tagged on public and charter schools ONLY."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Max schools to return"
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 200,
"default": 0,
"description": "Number of schools to skip, for paging"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}