Motley — NYC Neighborhoods, Schools & Admissions

Search and filter NYC neighborhoods by borough or name. Returns NTA codes, names, boroughs, and centroid coordinates.

{
  "type": "object",
  "properties": {
    "borough": {
      "type": "string",
      "enum": [
        "Manhattan",
        "Brooklyn",
        "Queens",
        "Bronx",
        "Staten Island"
      ],
      "description": "Filter by borough"
    },
    "query": {
      "type": "string",
      "description": "Search NTA name (case-insensitive)"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Max results"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of neighborhoods returned"
    },
    "neighborhoods": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "nta_code": {
            "type": "string"
          },
          "nta_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "borough": {
            "type": [
              "number",
              "null"
            ]
          },
          "borough_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "lat": {
            "type": [
              "number",
              "null"
            ]
          },
          "lng": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "nta_code",
          "nta_name",
          "borough",
          "borough_name"
        ],
        "additionalProperties": true
      }
    }
  },
  "required": [
    "count",
    "neighborhoods"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get full details for a single NYC neighborhood including demographics, raw 0-100 scores, location, and a family-readable interpretation (labeled score bands + cached editorial blurbs). Use the nta_code from search-neighborhoods.

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string",
      "maxLength": 6,
      "description": "NTA code (e.g. BK0101)"
    }
  },
  "required": [
    "nta_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string"
    },
    "nta_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "borough": {
      "type": [
        "number",
        "null"
      ]
    },
    "borough_name": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "nta_code",
    "nta_name",
    "borough",
    "borough_name"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a decision-ready, family-readable summary of one NYC neighborhood: a one-paragraph fit verdict, labeled score bands (e.g. 'Peace of Mind: strong (78/100)'), and cached editorial blurbs — with raw scores still available. The interpretation-first front door; start here when a family wants an answer, not a data dump.

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string",
      "maxLength": 6,
      "description": "NTA code (e.g. BK0101)"
    }
  },
  "required": [
    "nta_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string"
    },
    "nta_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "borough": {
      "type": [
        "number",
        "null"
      ]
    },
    "borough_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary": {
      "type": "string"
    }
  },
  "required": [
    "nta_code",
    "nta_name",
    "borough",
    "borough_name",
    "summary"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get schools within a neighborhood — public, charter, and private. Includes quality ratings, grade levels, contact info. Use count_only for a quick summary, or limit/offset to page the full list (the response reports total/returned).

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string",
      "maxLength": 6,
      "description": "NTA code"
    },
    "count_only": {
      "type": "boolean",
      "default": false,
      "description": "Return only counts by governance type"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Max schools to return (ignored when count_only)"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Number of schools to skip, for paging through the full list"
    }
  },
  "required": [
    "nta_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    }
  },
  "required": [
    "total"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find NYC schools citywide by what a family wants — borough, community school district (1-32), grade band (pre-K/elementary/middle/high), school type (public/charter/private), admissions method (zoned, screened, unscreened, limited unscreened, ed-opt, audition, SHSAT, charter lottery, private, universal pre-K), and program focus (arts, sports, STEM, language, academic, clubs). Use this when the family describes the KIND of school they want; use get-schools when you already have an nta_code and want everything in that neighborhood. Pass only the filters actually stated — at least one is required, and an invented one returns nothing. Program focus is tagged on public and charter schools only.

{
  "type": "object",
  "properties": {
    "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. Never guess 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",
          "unscreened",
          "limited_unscreened",
          "screened",
          "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#"
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "filters_applied": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "schools": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dbn": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "governance": {
            "type": [
              "string",
              "null"
            ]
          },
          "grade_levels": {
            "type": [
              "string",
              "null"
            ]
          },
          "district": {
            "type": [
              "number",
              "null"
            ]
          },
          "neighborhood": {
            "type": [
              "string",
              "null"
            ]
          },
          "nta_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "borough": {
            "type": [
              "string",
              "null"
            ]
          },
          "slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "category": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "examples": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "category",
                "label",
                "examples"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "dbn",
          "name",
          "address",
          "governance",
          "grade_levels",
          "district",
          "neighborhood",
          "nta_code",
          "borough",
          "slug"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "total",
    "returned",
    "filters_applied",
    "schools"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get family resource counts for a neighborhood: recreation centers, playgrounds, libraries, hospitals, farmers markets, ADA subway stations.

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string",
      "maxLength": 6,
      "description": "NTA code"
    }
  },
  "required": [
    "nta_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ntaCode": {
      "type": "string"
    }
  },
  "required": [
    "ntaCode"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get kids' activities and businesses in a neighborhood — classes, sports, arts, tutoring, etc. from Foursquare data. Use count_only for category breakdown, or limit/offset to page the full list (reports total/returned). Each place's last_refreshed is when we last verified it with Foursquare.

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string",
      "maxLength": 6,
      "description": "NTA code"
    },
    "count_only": {
      "type": "boolean",
      "default": false,
      "description": "Return only category counts"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Max activities to return (ignored when count_only)"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Number of activities to skip, for paging through the full list"
    }
  },
  "required": [
    "nta_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    }
  },
  "required": [
    "total"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get safety and health environment indicators for a neighborhood: crime complaints, collisions, HPD violations, air quality, lead levels, asthma rates — plus a family-readable interpretation of the Peace of Mind and Air & Water Quality scores.

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string",
      "maxLength": 6,
      "description": "NTA code"
    }
  },
  "required": [
    "nta_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ntaCode": {
      "type": "string"
    }
  },
  "required": [
    "ntaCode"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find neighborhoods most similar to a given one based on a 9-dimension score vector (family density, wealth, education, safety, transit, etc.). Returns similarity scores.

{
  "type": "object",
  "properties": {
    "nta_code": {
      "type": "string",
      "maxLength": 6,
      "description": "NTA code to find similar neighborhoods for"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 20,
      "default": 5,
      "description": "Number of comparable neighborhoods"
    }
  },
  "required": [
    "nta_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "source": {
      "type": "object",
      "properties": {
        "nta_code": {
          "type": "string"
        },
        "nta_name": {
          "type": "string"
        },
        "borough": {
          "type": [
            "number",
            "null"
          ]
        },
        "borough_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "viability_score": {
          "type": "number"
        },
        "scores_as_of": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "nta_code",
        "nta_name",
        "borough",
        "borough_name",
        "viability_score",
        "scores_as_of"
      ],
      "additionalProperties": false
    },
    "comparables": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "nta_code": {
            "type": "string"
          },
          "nta_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "similarity": {
            "type": "number"
          }
        },
        "required": [
          "nta_code",
          "nta_name",
          "similarity"
        ],
        "additionalProperties": true
      }
    }
  },
  "required": [
    "source",
    "comparables"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find which NYC neighborhood (NTA) an address or coordinate is in. Pass a NYC address (geocoded via OpenStreetMap) OR lat+lng. Returns the NTA code, name, borough, and a decision-ready family-fit summary. Use this to turn a real-world location into a neighborhood you can pass to the other tools.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 3,
      "description": "A NYC street address or place name (e.g. \"350 5th Ave, Manhattan\"). Geocoded via OpenStreetMap, NYC-bounded. Provide this OR lat+lng."
    },
    "lat": {
      "type": "number",
      "minimum": 40.49,
      "maximum": 40.92,
      "description": "Latitude (NYC box). Provide with lng instead of an address."
    },
    "lng": {
      "type": "number",
      "minimum": -74.26,
      "maximum": -73.68,
      "description": "Longitude (NYC box). Provide with lat instead of an address."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "address": {
          "type": [
            "string",
            "null"
          ]
        },
        "lat": {
          "type": [
            "number",
            "null"
          ]
        },
        "lng": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "address",
        "lat",
        "lng"
      ],
      "additionalProperties": false
    },
    "nta": {
      "type": "object",
      "properties": {
        "nta_code": {
          "type": "string"
        },
        "nta_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "borough": {
          "type": [
            "number",
            "null"
          ]
        },
        "borough_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "slug": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "nta_code",
        "nta_name",
        "borough",
        "borough_name",
        "slug"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "query",
    "nta"
  ],
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Rank NYC neighborhoods by what a family cares about. Pass per-metric weights (family density, schools, affordability, neighborhood character, transit, safety, air & water quality) and/or ranked priority keywords; optionally scope to one borough. Returns the top neighborhoods with a fit score and the metric breakdown — a deterministic weighted sort (the per-child Smart Match stays in the Motley app).

{
  "type": "object",
  "properties": {
    "weights": {
      "type": "object",
      "properties": {
        "family_density": {
          "type": "number",
          "minimum": 0
        },
        "education_orientation": {
          "type": "number",
          "minimum": 0
        },
        "wealth_index": {
          "type": "number",
          "minimum": 0
        },
        "neighborhood_stability": {
          "type": "number",
          "minimum": 0
        },
        "transit_accessibility": {
          "type": "number",
          "minimum": 0
        },
        "safety_score": {
          "type": "number",
          "minimum": 0
        },
        "health_environment": {
          "type": "number",
          "minimum": 0
        }
      },
      "additionalProperties": false,
      "description": "Per-metric importance (0+; higher = matters more). Any subset; normalized internally. Overrides priorities when both are given."
    },
    "priorities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ranked priority keywords, most important first — e.g. [\"safety\",\"schools\",\"affordability\"]. Mapped to metric weights with rank decay (used only when `weights` is absent)."
    },
    "borough": {
      "type": "string",
      "enum": [
        "Manhattan",
        "Brooklyn",
        "Queens",
        "Bronx",
        "Staten Island"
      ],
      "description": "Restrict the ranking to one borough"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "How many top neighborhoods to return"
    },
    "min_population": {
      "type": "integer",
      "minimum": 0,
      "default": 1000,
      "description": "Residential floor — drops parks/cemeteries/airports that score ~100 by having almost no residents (default 1000)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "weights_used": {
      "type": "object",
      "properties": {
        "family_density": {
          "type": "number",
          "minimum": 0
        },
        "education_orientation": {
          "type": "number",
          "minimum": 0
        },
        "wealth_index": {
          "type": "number",
          "minimum": 0
        },
        "neighborhood_stability": {
          "type": "number",
          "minimum": 0
        },
        "transit_accessibility": {
          "type": "number",
          "minimum": 0
        },
        "safety_score": {
          "type": "number",
          "minimum": 0
        },
        "health_environment": {
          "type": "number",
          "minimum": 0
        }
      },
      "required": [
        "family_density",
        "education_orientation",
        "wealth_index",
        "neighborhood_stability",
        "transit_accessibility",
        "safety_score",
        "health_environment"
      ],
      "additionalProperties": false
    },
    "scope": {
      "type": "object",
      "properties": {
        "borough": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "borough"
      ],
      "additionalProperties": false
    },
    "count": {
      "type": "number"
    },
    "scores_as_of": {
      "type": [
        "string",
        "null"
      ]
    },
    "neighborhoods": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "number"
          },
          "nta_code": {
            "type": "string"
          },
          "nta_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "borough_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "fit_score": {
            "type": "number"
          },
          "scores": {
            "type": "object",
            "properties": {
              "family_density": {
                "$ref": "#/properties/weights_used/properties/family_density"
              },
              "education_orientation": {
                "$ref": "#/properties/weights_used/properties/education_orientation"
              },
              "wealth_index": {
                "$ref": "#/properties/weights_used/properties/wealth_index"
              },
              "neighborhood_stability": {
                "$ref": "#/properties/weights_used/properties/neighborhood_stability"
              },
              "transit_accessibility": {
                "$ref": "#/properties/weights_used/properties/transit_accessibility"
              },
              "safety_score": {
                "$ref": "#/properties/weights_used/properties/safety_score"
              },
              "health_environment": {
                "$ref": "#/properties/weights_used/properties/health_environment"
              }
            },
            "required": [
              "family_density",
              "education_orientation",
              "wealth_index",
              "neighborhood_stability",
              "transit_accessibility",
              "safety_score",
              "health_environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "rank",
          "nta_code",
          "nta_name",
          "borough_name",
          "slug",
          "fit_score",
          "scores"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "weights_used",
    "scope",
    "count",
    "scores_as_of",
    "neighborhoods"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare 2–6 NYC neighborhoods side by side across the 9 family-fit metrics (Family Fit, Families, Affordability, Schools, Neighborhood Character, Transit, Safety, Health, Activities). Pass an array of NTA codes; returns a per-metric matrix with each neighborhood's band and the per-metric leader.

{
  "type": "object",
  "properties": {
    "nta_codes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 6
      },
      "minItems": 2,
      "maxItems": 6,
      "description": "2–6 NTA codes to compare side by side (from search-neighborhoods). Unscored codes are dropped."
    }
  },
  "required": [
    "nta_codes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "neighborhoods": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "nta_code": {
            "type": "string"
          },
          "nta_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "borough_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "slug": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "nta_code",
          "nta_name",
          "borough_name",
          "slug"
        ],
        "additionalProperties": false
      }
    },
    "metrics": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "values": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "nta_code": {
                  "type": "string"
                },
                "score": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "band": {
                  "type": "string"
                },
                "phrase": {
                  "type": "string"
                }
              },
              "required": [
                "nta_code",
                "score",
                "band",
                "phrase"
              ],
              "additionalProperties": false
            }
          },
          "leader_nta_code": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "key",
          "label",
          "values",
          "leader_nta_code"
        ],
        "additionalProperties": false
      }
    },
    "scores_as_of": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "neighborhoods",
    "metrics",
    "scores_as_of"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the full NYC school-admissions reference: every entry point from 3-K and Pre-K through Kindergarten, Gifted & Talented, and the 8 middle/high admission methods (SHSAT, audition, screened, Ed-Opt, limited unscreened, unscreened, zoned, charter lottery) — each with its typical application window. The methods carry a live program count plus a special_badge naming any extra ask beyond the standard application (an audition, a test, an open-house sign-in), null when there is none; optional band/governance filters narrow the count. Knowledge only.

{
  "type": "object",
  "properties": {
    "band": {
      "type": "string",
      "enum": [
        "middle",
        "high"
      ],
      "description": "Filter the MS/HS methods to one grade band"
    },
    "governance": {
      "type": "string",
      "enum": [
        "public",
        "charter"
      ],
      "description": "Filter the MS/HS program counts to public or charter schools"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string"
    },
    "filters": {
      "type": "object",
      "properties": {
        "band": {
          "type": [
            "string",
            "null"
          ]
        },
        "governance": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "band",
        "governance"
      ],
      "additionalProperties": false
    },
    "entry_points": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "stage": {
            "type": "string"
          },
          "short": {
            "type": "string"
          },
          "full": {
            "type": "string"
          },
          "typical_window": {
            "type": "string"
          }
        },
        "required": [
          "key",
          "label",
          "stage",
          "short",
          "full",
          "typical_window"
        ],
        "additionalProperties": false
      }
    },
    "methods": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "short": {
            "type": "string"
          },
          "full": {
            "type": "string"
          },
          "typical_window": {
            "type": "string"
          },
          "program_count": {
            "type": "number"
          },
          "special_badge": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "key",
          "label",
          "short",
          "full",
          "typical_window",
          "program_count",
          "special_badge"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "note",
    "filters",
    "entry_points",
    "methods"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Explain one NYC admission entry point or method in full — the plain-English explainer, its typical deadline window, and, when the method asks a family for more than a ranked application, exactly what it requires (audition or portfolio, SHSAT registration, a demonstrated-interest sign-in, a private school's own test/interview track) plus the extra paperwork that comes with it. Pass a method key (shsat, audition, screened, ed_opt, limited_unscreened, unscreened, zoned, charter_lottery, private_admissions, prek_universal) or an early entry point (three-k, pre-k, kindergarten, gifted-talented).

{
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "description": "An admission method key (shsat, audition, screened, ed_opt, limited_unscreened, unscreened, zoned, charter_lottery, private_admissions, prek_universal) OR an early entry point (three-k, pre-k, kindergarten, gifted-talented)."
    }
  },
  "required": [
    "method"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "entry_point",
        "method"
      ]
    },
    "key": {
      "type": "string"
    },
    "label": {
      "type": "string"
    },
    "short": {
      "type": "string"
    },
    "full": {
      "type": "string"
    },
    "typical_window": {
      "type": "string"
    },
    "stage": {
      "type": "string"
    },
    "program_count": {
      "type": "number"
    },
    "special_requirements": {
      "type": "object",
      "properties": {
        "badge": {
          "type": "string"
        },
        "headline": {
          "type": "string"
        },
        "requirements": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "extra_documents": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "required": {
                "type": "boolean"
              },
              "notes": {
                "type": "string"
              }
            },
            "required": [
              "label",
              "required",
              "notes"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "badge",
        "headline",
        "requirements",
        "extra_documents"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "kind",
    "key",
    "label",
    "short",
    "full",
    "typical_window"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get how competitive admission to one specific school is, program by program: seats vs. applicants, applicants-per-seat, offer/fill rate, and a family-readable competitiveness tier (Accessible / Competitive / Highly Competitive). Pass a school DBN (from get-schools). Sourced from MySchools — present mostly for screened/choice high-school programs; zoned, charter-lottery, and private schools usually have none.

{
  "type": "object",
  "properties": {
    "dbn": {
      "type": "string",
      "maxLength": 40,
      "description": "School DBN (e.g. 02M475 for Stuyvesant, 13K430 for Brooklyn Tech)"
    }
  },
  "required": [
    "dbn"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "dbn": {
      "type": "string"
    },
    "school_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "governance": {
      "type": [
        "string",
        "null"
      ]
    },
    "note": {
      "type": "string"
    },
    "programs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "program": {
            "type": [
              "string",
              "null"
            ]
          },
          "method": {
            "type": [
              "string",
              "null"
            ]
          },
          "seats": {
            "type": [
              "number",
              "null"
            ]
          },
          "applicants": {
            "type": [
              "number",
              "null"
            ]
          },
          "apps_per_seat": {
            "type": [
              "number",
              "null"
            ]
          },
          "offer_rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "fill_rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "competitiveness": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "program",
          "method",
          "seats",
          "applicants",
          "apps_per_seat",
          "offer_rate",
          "fill_rate",
          "competitiveness",
          "description"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "dbn",
    "school_name",
    "governance",
    "note",
    "programs"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}