Skip to main content
POST
/
properties
/
bulk
Bulk Properties
curl --request POST \
  --url https://data.apartmentiq.io/apartmentiq/api/v2/properties/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "{account_id}"
}
'
{
  "rows": [
    {
      "property_name": "The Livingston",
      "market_name": "Madison, WI Metro Area",
      "submarket_name": "Downtown Madison",
      "property_id": 781245,
      "address": "1025 E Washington Ave",
      "city": "Madison",
      "state": "WI",
      "zip_code": "53703",
      "latitude": 43.0836,
      "longitude": -89.3723,
      "unified_status": "stabilized",
      "unit_count": 186,
      "number_of_stories": 6,
      "year_built": 2018,
      "year_renovated": null,
      "property_class": "A",
      "property_type": "Multifamily",
      "management_company_names": [
        "Northstar Residential"
      ],
      "ownership_company_names": [
        "Lakeview Multifamily Fund"
      ],
      "on_revenue_management_tool": true,
      "period": "2026-05",
      "rent": 1842.37,
      "rent_0_bed": 1375.2,
      "rent_1_bed": 1698.44,
      "rent_2_bed": 2136.08,
      "rent_3_bed": 2698.5,
      "ner": 1796.12,
      "ner_0_bed": 1328.75,
      "ner_1_bed": 1654.1,
      "ner_2_bed": 2084.9,
      "ner_3_bed": 2630.25,
      "rent_psf": 2.48,
      "rent_0_bed_psf": 3.18,
      "rent_1_bed_psf": 2.72,
      "rent_2_bed_psf": 2.18,
      "rent_3_bed_psf": 1.92,
      "ner_psf": 2.42,
      "ner_0_bed_psf": 3.07,
      "ner_1_bed_psf": 2.65,
      "ner_2_bed_psf": 2.13,
      "ner_3_bed_psf": 1.87,
      "rent_growth_rate_yoy": 0.0341,
      "ner_growth_rate_yoy": 0.0317,
      "concession_value": 450,
      "concession_percent": 0.0204,
      "days_on_market": 27.46,
      "occupancy_percent": 0.9435,
      "leased_percent": 0.9562,
      "exposure_percent": 0.0874
    },
    {
      "property_name": "Summit Row",
      "market_name": "Madison, WI Metro Area",
      "submarket_name": "West Madison",
      "property_id": 781266,
      "address": "711 Junction Rd",
      "city": "Madison",
      "state": "WI",
      "zip_code": "53717",
      "latitude": 43.0719,
      "longitude": -89.5264,
      "unified_status": "lease_up",
      "unit_count": 244,
      "number_of_stories": 5,
      "year_built": 2024,
      "year_renovated": null,
      "property_class": "A",
      "property_type": "Multifamily",
      "management_company_names": [
        "Crescent Urban Living"
      ],
      "ownership_company_names": [],
      "on_revenue_management_tool": false,
      "period": "2026-05",
      "rent": 1718.92,
      "rent_0_bed": 1298.1,
      "rent_1_bed": 1586.25,
      "rent_2_bed": 1994.42,
      "rent_3_bed": null,
      "ner": 1634.75,
      "ner_0_bed": 1228.6,
      "ner_1_bed": 1508.32,
      "ner_2_bed": 1902.1,
      "ner_3_bed": null,
      "rent_psf": 2.31,
      "rent_0_bed_psf": 3.01,
      "rent_1_bed_psf": 2.54,
      "rent_2_bed_psf": 2.06,
      "rent_3_bed_psf": null,
      "ner_psf": 2.2,
      "ner_0_bed_psf": 2.85,
      "ner_1_bed_psf": 2.41,
      "ner_2_bed_psf": 1.96,
      "ner_3_bed_psf": null,
      "rent_growth_rate_yoy": null,
      "ner_growth_rate_yoy": null,
      "concession_value": 1250,
      "concession_percent": 0.0606,
      "days_on_market": 41.12,
      "occupancy_percent": 0.7811,
      "leased_percent": 0.8422,
      "exposure_percent": 0.1934
    }
  ],
  "pagination": {
    "current_page": 2,
    "total_pages": 4,
    "total_count": 175,
    "per_page": 50
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Request contract for the API V2 properties bulk export endpoint.

​
account_id
required

ApartmentIQ account ID used to set the request account context.

​
interval
enum<string>

Optional period bucket for requested metrics. Omit for one summary row per property.

Available options:
month,
quarter,
year
​
fields
enum<string>[]

Optional metric field names. Omit or pass an empty array for identity-only rows.

Metric field to include in each property row.

Available options:
rent,
rent_0_bed,
rent_1_bed,
rent_2_bed,
rent_3_bed,
ner,
ner_0_bed,
ner_1_bed,
ner_2_bed,
ner_3_bed,
rent_psf,
rent_0_bed_psf,
rent_1_bed_psf,
rent_2_bed_psf,
rent_3_bed_psf,
ner_psf,
ner_0_bed_psf,
ner_1_bed_psf,
ner_2_bed_psf,
ner_3_bed_psf,
rent_growth_rate_yoy,
ner_growth_rate_yoy,
concession_value,
concession_percent,
days_on_market,
occupancy_percent,
leased_percent,
exposure_percent
​
property_filters
object

Filters used to select properties and constrain the metric aggregation date range.

​
page
integer
default:1

One-based page number for the export result set.

Required range: x >= 1
​
per_page
integer
default:25

Number of rows per page. Values above the maximum are clamped.

Required range: 1 <= x <= 100

Response

Bulk property rows and pagination metadata.

Paginated property bulk export results.

​
rows
object[]
required

Property rows for the current page. Each row includes property identity fields and any requested metric fields.

​
pagination
object
required

Pagination details for the property bulk export rows.