---
title: "Search for a school in a location"
method: GET
path: "/v2/schools/{latitude}/{longitude}"
tags: ["Schools"]
---

# Search for a school in a location

`GET /v2/schools/{latitude}/{longitude}`

## Request

- Base URL: `https://api.domain.com.au`
- URL: `https://api.domain.com.au/v2/schools/{latitude}/{longitude}`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://auth.domain.com.au/v1/connect/authorize`
    - Client credentials
    - Token URL: `https://auth.domain.com.au/v1/connect/token` scopes: `api_locations_read`
- TypeScript: <https://skmtc.dev/domain/apis/domain-public-api/docs/v2/schools/:latitude/:longitude/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `latitude` number, double, required
- `longitude` number, double, required

## Response `200`

Schools data returned

- SchoolsV2SchoolWithDistance[]
  - `distance` number, double, nullable: Gets or Sets Distance
  - `school` SchoolsV2School: School
    - `schoolSector` 'Catholic' | 'Government' | 'Independent', nullable: Gets or Sets SchoolSector
    - `schoolType` 'Combined' | 'Primary' | 'Secondary' | 'Special', nullable: Gets or Sets SchoolType
    - `gender` 'Boys' | 'Girls' | 'CoEd', nullable: Gets or Sets Gender
    - `name` string, nullable: Gets or Sets Name
    - `suburb` string, nullable: Gets or Sets Suburb
    - `state` string, nullable: Gets or Sets State
    - `postcode` string, nullable: Gets or Sets Postcode
    - `centroid` string, nullable: Gets or Sets Centroid
    - `profile` SchoolsV2SchoolProfile: SchoolProfile
      - `url` string, nullable: Website for the school
      - `yearRange` string, nullable: The range of year levels offered by the school.
      - `icsea` integer, nullable: The Index of Community Socio-Educational Advantage score for the school. This score is derived from a number of variables including parental school and non-school education and occupation, the school’s geographical location and proportion of Indigenous students.
      - `bottomSeaQuarter` integer, nullable: The percentage of students positioned in the lowest socio-educational advantage quarter.
      - `lowerMiddleSeaQuarter` integer, nullable: The percentage of students positioned in the lower middle socio-educational advantage quarter.
      - `upperMiddleSeaQuarter` integer, nullable: The percentage of students positioned in the higher middle socio-educational advantage quarter.
      - `topSeaQuarter` integer, nullable: The percentage of students positioned in the highest socio-educational advantage quarter.
      - `totalEnrolments` integer, nullable: The total number of students, including both full-time and part-time students, who are enrolled at the school in the calendar year specified.
      - `girlsEnrolments` integer, nullable: The total number of female students, including both full-time and part-time students, who are enrolled at the school in the calendar year specified.
      - `boysEnrolments` integer, nullable: The total number of male students, including full-time and part-time students, who are enrolled at the school in the calendar year specified.
    - `catchments` SchoolsV2SchoolCatchment[], nullable: Gets or Sets Catchments
      - `type` 'Primary' | 'Secondary', nullable: Gets or Sets Type
    - `domainId` integer, nullable: Gets or Sets DomainId

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/domain/apis/domain-public-api.md) - [All operations](https://skmtc.dev/domain/apis/domain-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/domain/apis/domain-public-api/revisions/133015c6842c?raw)