---
title: "Get area schools"
method: GET
path: "/v1/area/schools"
tags: ["Signals"]
---

# Get area schools

`GET /v1/area/schools`

## Request

- Base URL: `https://api.onegoodarea.com`
- URL: `https://api.onegoodarea.com/v1/area/schools`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

The inspected schools within 1.5km of a UK postcode, nearest first, by name and grade: the entities behind the aggregated schools.* signals, as /v1/area/transactions is for property.*. England is served from the Ofsted register; Wales and Scotland return an empty list with the reason their inspectorate publishes no comparable grades.

## Query parameters

- `postcode` string, required

## Response `200`

Default Response

- object
  - `postcode` string, required
  - `lsoa` string, required
  - `country` string, required
  - `inspectorate` string, required
  - `radius_m` number, required
  - `distance_from` 'neighbourhood_centroid' | 'postcode', required
  - `coverage_note` string, required
  - `school_count` number, required
  - `schools` object[], required
    - `urn` number, required
    - `name` string, required
    - `phase` string, required
    - `overall_effectiveness` number, required
    - `rating` string, required
    - `grade_source` 'report_card' | 'overall' | 'quality_of_education' | 'ungraded_inspection', required
    - `inspection_date` string, required
    - `distance_m` number, required
  - `meta` object, required
    - `engine_version` string, required
    - `generated_at` string, required
    - `fetch_mode` 'store' | 'live' | 'none', required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: Default Response
- `429`: Default Response
- `500`: Default Response
- `502`: Default Response

## Changes

- **2026-10-20** `b318d28b3412`: 6 warning
  - added the new `nation_not_covered` enum value to the `anyOf[subschema #1]/code` response property for the response status `404`
  - added the new `nation_not_covered` enum value to the `anyOf[subschema #1]/reason` response property for the response status `404`
  - added the new `nation_not_covered` enum value to the `code` response property for the response status `422`
  - added the new `nation_not_covered` enum value to the `code` response property for the response status `502`
  - …2 more

[Operation history](https://skmtc.dev/onegoodarea/apis/onegoodarea-api/changes/v1/area/schools/get.md)

---

[API](https://skmtc.dev/onegoodarea/apis/onegoodarea-api.md) · [All operations](https://skmtc.dev/onegoodarea/apis/onegoodarea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/onegoodarea/apis/onegoodarea-api/revisions/b318d28b3412?raw)