llms.txt Content
# DistrictAPI — LLM Reference
DistrictAPI is a REST API for US public school district and school data, built on free federal datasets (NCES CCD, NCES EDGE, Census TIGER). Every US public school district and school is covered.
Base URL: https://api.districtapi.dev
Current version: v1
Data vintage: NCES 2024-25 (released December 2025)
---
## Authentication
Pass an API key on every request using one of:
Header: X-API-Key: sk_live_...
Header: Authorization: Bearer sk_live_...
API keys are obtained free at https://districtapi.dev/dashboard (500 requests/month, no credit card).
---
## Rate Limits
| Plan | Per minute | Per month |
|------------|------------|-----------|
| Free | 10 | 500 |
| Starter | 60 | 10,000 |
| Pro | 120 | 50,000 |
| Growth | 300 | 200,000 |
Exceeding per-minute limit → 429 RATE_LIMIT_EXCEEDED
Exceeding monthly limit → 402 QUOTA_EXCEEDED
Monthly quotas reset on the 1st of each calendar month.
---
## Response Envelope
Every successful response uses this envelope:
{
"data": <object or array — see each endpoint>,
"meta": {
"requestId": "req_9f4b2a1c8e3d",
"creditsUsed": 1,
"creditsRemaining": 499
},
"source": {
"ncesYear": "2024-25",
"updatedAt": "2025-12-15",
"freshnessDays": 131
}
}
All field names in responses are camelCase.
Each API call costs 1 credit regardless of results returned.
---
## Important: Overlapping Districts
Some US addresses are served by multiple school districts — for example, a city may have a separate elementary district (K-8) and high school district (9-12) whose boundaries overlap. The GET /v1/districts endpoint always returns an array. Most addresses return one district; split-district areas return two. Always iterate over the array rather than assuming a single result.
---
## Endpoints
### GET /v1/districts
Look up all school districts serving an address or coordinates.
Returns an array o