Developers
HOAs Graded Public API
Three read-only endpoints for HOA grades, fees, reviews, and legal history. Free tier is unauthenticated and rate-limited to 100 requests per IP per day. Higher tiers require an API key — generate one from the developer portal.
Authentication
Pass your API key in the X-HOA-API-Key header. Keys generated from the developer portal start in the free tier.
curl -H "X-HOA-API-Key: hga_xxxxxxxxxxxx" \ https://hoasgraded.com/api/public/v1/hoa/lakeside-villas
GET
/api/public/v1/hoa/{slug}Single HOA
Returns the public summary for a single HOA.
Example request
curl https://hoasgraded.com/api/public/v1/hoa/lakeside-villas
Example response
{
"hoa_name": "Lakeside Villas",
"grade_letter": "B+",
"grade_score": 74.5,
"fee_low": 280,
"fee_high": 340,
"units": 184,
"management_company": "Cedar Property Mgmt",
"review_count": 27,
"average_rating": 4.1,
"litigation_active": false,
"data_updated": "2026-05-14",
"full_report_url": "https://hoasgraded.com/hoa/lakeside-villas"
}GET
/api/public/v1/hoas?zip={zip}HOAs by ZIP code
Returns an array of summary objects for every graded HOA in the given 5-digit ZIP code.
Example request
curl "https://hoasgraded.com/api/public/v1/hoas?zip=78704"
Example response
[
{
"hoa_name": "Lakeside Villas",
"grade_letter": "B+",
"grade_score": 74.5,
"full_report_url": "https://hoasgraded.com/hoa/lakeside-villas"
}
]GET
/api/public/v1/hoa/{slug}/badgeEmbeddable badge
Returns a self-contained HTML snippet showing the grade badge, linking back to the full profile. Drop it into any web page.
Example request
curl https://hoasgraded.com/api/public/v1/hoa/lakeside-villas/badge
Example response
<a href="https://hoasgraded.com/hoa/lakeside-villas" ...> <span>HOA Community Score</span> <strong>B+</strong> <small>74.5 / 100</small> </a>