Schools
England
Wales
gethttps://crystalroof.co.uk/customer-api/education/closest-schools/v1/{location}
Description
This method returns the closest schools based on the specified criteria.
The dataset comprises multiple source datasets published by the Department for Education, and it is updated as soon as relevant datasets become available.
Parameters
| Name | Description |
|---|---|
location path string | Postcode, coordinates in the lat,long format or UPRN in the uprn12345678 format. Postcode with or without space. This argument is case-insensitive. |
educationPhase query array | Education phase: primary, secondary and 16 plus. |
ofstedRating query array | ofstedRating represents the overall rating we calculate for schools based on Ofsted’s category judgements, using a method similar to Ofsted's previous approach. This rating is not provided directly by Ofsted but follows their assessment framework, categorising schools from "Outstanding" to "Inadequate." |
funding query array | State-funded schools do not charge tuition fees. Independent schools charge tuition fees. |
gender query array | Boys, girls or co-education (mixed) |
limit query enum | Number of elements to be returned by the method. The returned number of elements may be less than the requested amount if fewer elements are found based on your criteria (in very rare cases). The maximum value is 20. To retrieve only the metadata, use the value 0. |
api_key query enum | Your API key.
|
Request URL:
https://crystalroof.co.uk/customer-api/education/closest-schools/v1/W60WW?api_key=DEMO
Possible responses with examples
Code
Description
200
Success
{
"data": [
{
"urn": 100373,
"name": "Ravenscourt Park Preparatory School",
"distance": 383.5,
"latitude": 51.494106,
"longitude": -0.238423,
"address": "16 Ravenscourt Avenue, Ravenscourt Park, W6 0SL",
"website": "www.rpps.co.uk",
"phone": "02088469153",
"localAuthority": "Hammersmith and Fulham",
"isPrimary": true,
"isSecondary": false,
"isPost16": false,
"ofstedRating": null,
"ofstedInspectionDate": null,
"schoolType": "Independent schools",
"admission": "Non-selective",
"sixthForm": "Does not have a sixth form",
"schoolCapacity": 420,
"numberOfPupils": 416,
"ageLow": 4,
"ageHigh": 11,
"gender": "Mixed",
"religion": "None"
},
{
"urn": 100352,
"name": "St Peter's Primary School",
"distance": 480.2,
"latitude": 51.492162,
"longitude": -0.240111,
"address": "33 St Peter's Road, Hammersmith, W6 9BA",
"website": "www.stpetersce.lbhf.sch.uk/",
"phone": "02087487756",
"localAuthority": "Hammersmith and Fulham",
"isPrimary": true,
"isSecondary": false,
"isPost16": false,
"ofstedRating": "Outstanding",
"ofstedInspectionDate": "22-02-2023",
"schoolType": "Local authority maintained schools",
"admission": "Not applicable",
"sixthForm": "Does not have a sixth form",
"schoolCapacity": 210,
"numberOfPupils": 205,
"ageLow": 4,
"ageHigh": 11,
"gender": "Mixed",
"religion": "Church of England"
},
{
"urn": 100346,
"name": "John Betts Primary School",
"distance": 508.1,
"latitude": 51.496826,
"longitude": -0.235696,
"address": "Paddenswick Road, W6 0UA",
"website": "www.johnbetts.lbhf.sch.uk",
"phone": "02087482465",
"localAuthority": "Hammersmith and Fulham",
"isPrimary": true,
"isSecondary": false,
"isPost16": false,
"ofstedRating": "Good",
"ofstedInspectionDate": "04-11-2021",
"schoolType": "Local authority maintained schools",
"admission": "Not applicable",
"sixthForm": "Does not have a sixth form",
"schoolCapacity": 210,
"numberOfPupils": 207,
"ageLow": 5,
"ageHigh": 11,
"gender": "Mixed",
"religion": "None"
},
{
"urn": 100370,
"name": "Latymer Upper School",
"distance": 511.7,
"latitude": 51.49303,
"longitude": -0.237441,
"address": "237 King Street, Hammersmith, W6 9LR",
"website": "www.latymer-upper.org",
"phone": "02086292024",
"localAuthority": "Hammersmith and Fulham",
"isPrimary": true,
"isSecondary": true,
"isPost16": true,
"ofstedRating": null,
"ofstedInspectionDate": null,
"schoolType": "Independent schools",
"admission": "Selective",
"sixthForm": "Has a sixth form",
"schoolCapacity": 1450,
"numberOfPupils": 1439,
"ageLow": 7,
"ageHigh": 19,
"gender": "Mixed",
"religion": "None"
},
{
"urn": 136750,
"name": "West London Free School",
"distance": 533.2,
"latitude": 51.492523,
"longitude": -0.237821,
"address": "241 King Street, W6 9LP",
"website": "http://www.wlfs.org/",
"phone": "02086000670",
"localAuthority": "Hammersmith and Fulham",
"isPrimary": false,
"isSecondary": true,
"isPost16": true,
"ofstedRating": "Good",
"ofstedInspectionDate": "22-06-2022",
"schoolType": "Free Schools",
"admission": "Non-selective",
"sixthForm": "Has a sixth form",
"schoolCapacity": 890,
"numberOfPupils": 911,
"ageLow": 11,
"ageHigh": 18,
"gender": "Mixed",
"religion": "None"
}
],
"dataDate": "2024-01-03",
"refreshedDate": "2024-01-03"
} 401
Unauthorized
{
"error": "No such API key or it is not valid anymore."
} 402
Payment Required
{
"error": "You have exhausted the available calls provided by your package."
} 403
Forbidden
{
"error": "API key is invalid for the given action."
} 404
Not Found
{
"error": "Can't find such location."
} 429
Too Many Requests
{
"error": "Too many requests have been sent in one second."
} 500
Internal Server Error
{
"error": "We have already started working on a resolution!"
} 
