Schools & districts

On this page

The examples use YOUR_KEY. Get a free key to run them; it takes about a minute and needs no card.Get a free key

For any point in the United States, /v1/schools returns the public school districts that serve it and, grade by grade, the assigned public school with its attendance zone. It covers every US public school district and public school, and you may store the results.

For IDX platforms, enterprise and wholesale buyers. School data comes with a platform or enterprise contract, or as a data licence. It isn't part of the self-serve plans. Start a platform pilot or write to sales@pinsharing.com.

curl "https://api.pinsharing.com/v1/schools?lat=41.8789&lon=-87.6359&key=YOUR_KEY"

{
  "coverage": "zone",
  "districts": [{ "id": "1709930", "name": "City of Chicago School District 299", "type": "unified", "grades": "PK-12" }],
  "assigned": [
    { "grades": "KG-08",
      "school": { "id": "170993000…", "name": "…", "address": { … }, "lat": 41.87, "lon": -87.63, "distance_m": 900 },
      "zone": { "method": "district_gis", "confidence": 0.97, "school_year": "2025-2026", "source": "https://data.cityofchicago.org/d/x72b-38qv" } }
  ],
  "unassigned": [],
  "notice": "Attendance boundaries change. Verify enrolment with the school district before relying on an assignment."
}

Parameters

Parameter	Meaning
`lat`, `lon`	The home or listing, in decimal degrees (required). Geocode an address first if you only have the address.
`grade`	Only this grade: `PK`, `K` or `1` to `12`. Leave it out for every grade.

Reading the answer

coverage: zone when every grade has an attendance zone; partial when some do; district_only when only the district is known; none outside any US school district.
assigned: one entry per run of grades with the same school, with the zone's method, confidence, school_year and source.
unassigned: grades whose zone we haven't mapped yet, with the district's nearest regular public schools for those grades. These are not assignments.

Zones

Each zone carries its method, a confidence score, the school_year it applies to and a source you can check. Charter and fully virtual schools are never shown as assigned.

Coverage (November 2026)

Every US public school district (13,368) and public school (101,110), from NCES and the U.S. Census Bureau.
Attendance zones in 12,652 districts in every state: 63,351 of 82,889 regular public schools have one, and 9,871 districts are covered for every school.
Every zone states the school year it applies to. Older zones are replaced as districts publish current maps, and we add districts every month.
Current boundary maps published by districts, cities and counties cover 38,152 schools in 1,090 districts, including:

Metro	District	Zones	School year
Chicago, IL	Chicago Public Schools and 16 suburban districts	480	2025-26 for Chicago; suburban maps as each district publishes them
New York, NY	New York City public schools (elementary and middle)	779	2024-25

Fair housing

PinSharing returns boundaries and school facts only: no ratings, test scores or demographic data. Show the district's own sources next to an assignment and the notice that boundaries change.

How to get it

API access is included in platform and enterprise contracts.
Data licence: the whole dataset in your own database (districts, schools and every published zone, refreshed as zones are added), from $5,000 a year, under the School Data Licence terms. Use it in your own products and keep what you downloaded after the licence ends; reselling the dataset needs a separate agreement.

Buy the data licence: $5,000 a year Pay by invoice

Buying means you agree to the School Data Licence terms. Card or US bank account through Stripe. After payment, sign in to your dashboard with the same email to download; downloads need two-step sign-in and each link works once. For an invoice (net 30), write to sales@pinsharing.com with your company name and billing contact. API access comes with a platform contract.

↑ Contents