“Quick answerA property condition API returns one grade for a property's physical state, read from its listing photos: Excellent, Good, Outdated, Poor or Very Poor. On 12 November 2026, 97.8% to 99.2% of active detached listings in Columbus, Phoenix and Cleveland carried a grade in our database. The share graded Outdated or worse ran from 24.2% in Phoenix to 71.0% in Cleveland. You can call the grade per address, filter a whole city by it, or ask for it in plain language through MCP.
Build with this data
Software developers can pull this data straight from the Homesage.ai real estate APIs. Start with these 2 endpoints.
What the condition grade measures
The grade answers one question: how much work a property needs before it competes with updated properties nearby. It is read from the property's listing photos and comes back as one of five labels.
| Grade | How to read it |
|---|---|
| Excellent | Updated finishes throughout. Ready to live in or rent. |
| Good | Well kept. Cosmetic work at most. |
| Outdated | Livable, with dated kitchens, baths or finishes. |
| Poor | Visible repairs needed before most buyers or tenants move in. |
| Very Poor | Major repairs. The property may not be livable as it stands. |
A grade is not an inspection. Photos do not show wiring, plumbing or anything inside the walls, so the grade sorts properties and an inspection confirms one. Our guide to the property condition report covers what a full inspection adds.
How condition differs by market
We counted active detached listings by grade in three cities on the same day. The same filter returns very different lists depending on where you run it.
| Active detached listings | Columbus, OH | Phoenix, AZ | Cleveland, OH |
|---|---|---|---|
| All listings | 1,469 | 2,753 | 893 |
| Carrying a grade | 1,444 (98.3%) | 2,730 (99.2%) | 873 (97.8%) |
| Excellent | 118 (8.2%) | 595 (21.8%) | 45 (5.2%) |
| Good | 715 (49.5%) | 1,474 (54.0%) | 208 (23.8%) |
| Outdated | 505 (35.0%) | 601 (22.0%) | 466 (53.4%) |
| Poor | 96 (6.6%) | 53 (1.9%) | 138 (15.8%) |
| Very Poor | 10 (0.7%) | 7 (0.3%) | 16 (1.8%) |
| Outdated or worse | 611 (42.3%) | 661 (24.2%) | 620 (71.0%) |
Our property database, active detached listings, 12 November 2026. Shares by grade are of graded listings. Very Poor includes listings the search marks unlivable. Counts move daily.
In Cleveland, 7 in 10 graded listings are Outdated or worse. In Phoenix, about 1 in 4 are. Housing age is part of the gap: the median owner-occupied US home is 42 years old, and Arizona is among the states where half of owner-occupied homes were built in the past 29 years, according to NAHB's analysis of the 2024 American Community Survey.
Coverage matters as much as the mix. In all three cities, fewer than 3 in 100 active detached listings had no grade, so a screen built on condition sees almost the whole market.
How to get the grade through the API
Send an address and the response carries the grade. We ran this call on 12 November 2026 with the sample address from our API documentation.
curl 'https://api.homesage.ai/api/properties/property-condition/?property_address=4411%20E%20Hidden%20Oak%20St%2C%20Springfield%2C%20MO%2C%2065802' \
-H 'Authorization: Bearer YOUR_API_KEY'
{"Property Condition": "Excellent"}
Plan for a missing grade. On 12 November, 25 of 1,469 active detached listings in Columbus had none, so carry the empty value to your screen instead of a default. The property condition API reference lists every response.
Filter a whole area by grade
The search count call turns the grade into a market metric. This one counts active detached listings in Cleveland graded Outdated or worse, the 620 in the table above.
curl 'https://api.homesage.ai/api/workspace/search/count/?location=%5B%7B%22type%22%3A%22city%22%2C%22city%22%3A%22Cleveland%22%2C%22state_code%22%3A%22OH%22%7D%5D&property_status=active&property_type=detached&property_condition=outdated%7Cpoor%7Cvery%20poor%7Cunlivable' \
-H 'Authorization: Bearer YOUR_API_KEY'
{"count": 620, "cost": 620}
The count call itself costs 0 credits. The cost field is what the full search would charge, 1 credit per property returned.
The full search then returns each matching property with its grade, estimated value and estimated returns. Our guide to property data APIs shows how condition sits next to rent and return signals in one stack.
How to use it through MCP
MCP brings the same data into Claude, ChatGPT, Cursor and other AI tools, so an analyst can ask for a grade in plain language. Setup takes three steps.
- Copy your personal connection link from your developer dashboard.
- In your AI tool, add a custom connector and paste the link.
- Sign in once with your account.
Then ask, for example, "What condition is 4411 E Hidden Oak St, Springfield, MO in?" or "How many active detached listings in Cleveland, OH are Outdated or worse?" The real estate MCP page lists every tool it carries.
Pricing the work from your own photos
Listing photos go stale after a sale or a renovation. When you hold newer photos, the renovation cost breakdown API accepts up to 30 of your own photo URLs, with the property's square footage, bedrooms and bathrooms. It returns an estimated renovation cost room by room.
Analyses of your own photos stay private. They never change the property's stored grade, which still comes from its listing photos.
Where the grade fits in a product
- Screen listing feeds: send Outdated and worse to a fixer list, and Good and better to a move-in-ready list.
- Read value in context: show the grade next to the estimated value, so users see what condition the number assumes.
- Route to inspection: mark Poor and Very Poor as "inspect before offer".
- Size the work: pair the grade with the estimated renovation cost for the same address.
- Track a market: run the count by city each week and chart the share that is Outdated or worse.
Investors will recognize the Outdated and Poor grades as what listings call "needs TLC".
Key takeaways
- A property condition API returns one of five grades, from Excellent to Very Poor, read from listing photos.
- On 12 November 2026, 97.8% to 99.2% of active detached listings in Columbus, Phoenix and Cleveland carried a grade.
- Outdated or worse was 24.2% of graded listings in Phoenix, 42.3% in Columbus and 71.0% in Cleveland.
- The search count call turns condition into a market metric you can chart by city every week.
- A grade sorts properties. An inspection confirms one, because photos do not show what sits inside the walls.
Conclusion
Condition is the field that turns a list of listings into a list of decisions. Start with the count for your market, then pull grades for the addresses that matter.
Homesage.ai offers 30+ endpoints with insights on 160M+ US properties, through the APIs, MCP and the web app. Start now to get an API key, read the API docs, or book a demo to see grades for your own addresses.
Frequently asked questions
What does a property condition API return?
One grade for the property's physical state: Excellent, Good, Outdated, Poor or Very Poor. The grade is read from the property's listing photos.
How is it different from a property condition report?
A property condition report is a written record from an inspection. The API grade comes from photos and is built to sort many properties fast. Use the grade to choose which properties to inspect.
Does every listing have a grade?
Almost. On 12 November 2026, 97.8% to 99.2% of active detached listings in Columbus, Phoenix and Cleveland carried one. Show a missing grade as missing rather than filling in a default, so users never act on a guess.
Can I use my own photos?
Yes, to estimate the work. Send up to 30 photo URLs with the property's size, bedrooms and bathrooms to the renovation cost breakdown API, and it returns an estimated renovation cost room by room.
Can I get the grade inside ChatGPT or Claude?
Yes. Connect the real estate MCP once, sign in, and ask for the condition of any US address in plain language.
Sources
- NAHB Eye on Housing, age of housing stock by state, 2024 American Community Survey data, read 12 November 2026.
- Our property condition API reference, call run 12 November 2026.
- Our search count API reference, counts pulled 12 November 2026.
Condition grades and estimated renovation costs are estimates, not an inspection or investment advice. Property data as of 12 November 2026.