Skip to main content

Overview

The Schools API provides access to detailed information about 32,000+ schools across the UK, including:
  • Primary and secondary schools
  • Independent and state schools
  • Ofsted ratings and inspection data
  • Performance metrics and statistics
  • Geographic search (nearby and within boundary)

Available Endpoints

Quick Start

Find Schools Near a Location

import { SDK } from '@vepler/sdk';

const vepler = new SDK({ apiKey: process.env.VEPLER_API_KEY });

// Search for schools within 2km of coordinates
const response = await vepler.schools.getV1SchoolsSearchNearby({
  latitude: 51.5074,
  longitude: -0.1278,
  radius: 2000
});

Get School Details

// Get by school ID
const school = await vepler.schools.getV1SchoolsId({ id: 'sch_123' });

// Get by URN (Unique Reference Number)
const byUrn = await vepler.schools.getV1SchoolsByUrnUrn({ urn: '100000' });

// Get by slug
const bySlug = await vepler.schools.getV1SchoolsBySlugSlug({ slug: 'westminster-academy' });

Filtering Options

Most endpoints support filtering via query parameters:
ParameterTypeDescriptionExample
statusstringSchool statusopen, closed
typestringSchool typeAcademy, Community
phasestringEducation phasePrimary, Secondary
ratingstringOfsted ratingOutstanding, Good
localAuthoritystringLocal authorityWestminster
minPupilsnumberMinimum pupils500
maxPupilsnumberMaximum pupils2000

Data Sources

School data is sourced from:
  • Ofsted — Inspection ratings and reports
  • Department for Education — School census and performance tables
  • Get Information About Schools (GIAS) — Official school register

Next Steps