Skip to main content
GET
/
markets
/
narratives
Get Market Narrative
curl --request GET \
  --url https://data.apartmentiq.io/apartmentiq/api/v1/markets/narratives \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "42",
      "type": "narrative",
      "attributes": {
        "id": 42,
        "geo_boundary_id": 94121,
        "analysis_date": "2026-03-15",
        "overview": "The Raleigh-Cary metro area continued to demonstrate strong fundamentals in Q1 2026, with steady rent growth and healthy absorption across most submarkets.",
        "rent": "Average effective rents rose 3.2% year-over-year, outpacing the national average. Class A properties led gains at 4.1%, while Class B and C segments posted more modest increases of 2.8% and 2.1% respectively.",
        "occupancy": "Occupancy rates held firm at 94.8%, supported by continued in-migration and job growth in the technology and life sciences sectors. Net absorption totaled approximately 2,400 units during the quarter.",
        "construction": "The construction pipeline remains active with over 8,500 units currently under construction. Deliveries are expected to peak in mid-2026 before tapering through year-end.",
        "sales": "Investment sales volume reached $420M across 12 transactions during the quarter, with cap rates averaging 5.2% for institutional-quality assets...",
        "demographics": "The metro area added approximately 18,000 new residents over the past year, driven by strong employment growth in technology, healthcare, and professional services sectors."
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

account_id
integer
required

ID of the ApartmentIQ account.

geo_boundary_id
integer
required

ID of the geographic boundary to retrieve the narrative for. Find IDs using the Search Geo Boundaries endpoint.

Response

Successfully retrieved market narrative.

data
object[]
required

Array of market narrative resources. Contains at most one narrative (the most recent available for the geo boundary), or an empty array if no narrative exists.