Skip to main content
POST
/
markets
/
bulk
Bulk Markets
curl --request POST \
  --url https://data.apartmentiq.io/apartmentiq/api/v2/markets/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "{account_id}"
}
'
{
  "rows": [
    {
      "name": "Madison, WI Metro Area",
      "geo_boundary_id": 4127,
      "geo_type": "MSA",
      "msa_name": null,
      "submarket_name": null,
      "period": "2026-05",
      "rent": 1784.22,
      "rent_0_bed": 1328.15,
      "rent_1_bed": 1626.4,
      "rent_2_bed": 2038.72,
      "rent_3_bed": 2544.18,
      "ner": 1738.66,
      "ner_0_bed": 1284.3,
      "ner_1_bed": 1588.94,
      "ner_2_bed": 1984.62,
      "ner_3_bed": 2481.35,
      "rent_psf": 2.36,
      "rent_0_bed_psf": 3.04,
      "rent_1_bed_psf": 2.61,
      "rent_2_bed_psf": 2.1,
      "rent_3_bed_psf": 1.83,
      "ner_psf": 2.3,
      "ner_0_bed_psf": 2.94,
      "ner_1_bed_psf": 2.55,
      "ner_2_bed_psf": 2.04,
      "ner_3_bed_psf": 1.78,
      "rent_growth_rate_yoy": 0.0284,
      "ner_growth_rate_yoy": 0.0269,
      "concession_value": 410.25,
      "concession_percent": 0.0196,
      "days_on_market": 27.46,
      "occupancy_percent": 0.9411,
      "leased_percent": 0.9534,
      "exposure_percent": 0.0892,
      "absorbed_unit_count": 612,
      "delivered_unit_count": 544
    },
    {
      "name": "Downtown Madison",
      "geo_boundary_id": 90114,
      "geo_type": "Submarket",
      "msa_name": "Madison, WI Metro Area",
      "submarket_name": null,
      "period": "2026-05",
      "rent": 1922.41,
      "rent_0_bed": 1442.88,
      "rent_1_bed": 1776.5,
      "rent_2_bed": 2264.72,
      "rent_3_bed": null,
      "ner": 1858.03,
      "ner_0_bed": 1379.18,
      "ner_1_bed": 1718.06,
      "ner_2_bed": 2202.44,
      "ner_3_bed": null,
      "rent_psf": 2.58,
      "rent_0_bed_psf": 3.23,
      "rent_1_bed_psf": 2.81,
      "rent_2_bed_psf": 2.22,
      "rent_3_bed_psf": null,
      "ner_psf": 2.49,
      "ner_0_bed_psf": 3.09,
      "ner_1_bed_psf": 2.72,
      "ner_2_bed_psf": 2.16,
      "ner_3_bed_psf": null,
      "rent_growth_rate_yoy": 0.0376,
      "ner_growth_rate_yoy": 0.0344,
      "concession_value": 520,
      "concession_percent": 0.0238,
      "days_on_market": 22.08,
      "occupancy_percent": 0.9488,
      "leased_percent": 0.9615,
      "exposure_percent": 0.0754,
      "absorbed_unit_count": 118,
      "delivered_unit_count": 96
    }
  ],
  "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 markets 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 market.

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. Absorption and delivery fields require interval quarter.

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,
absorbed_unit_count,
delivered_unit_count
​
geo_filters
object

Market selection filters. Omit to page through all supported market boundaries.

​
property_filters
object

Property filters used when calculating market-level metric values.

​
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 market rows and pagination metadata.

Paginated market bulk export results.

​
rows
object[]
required

Market rows for the current page. Each row includes market identity fields and any requested metric fields.

​
pagination
object
required

Pagination details for the market bulk export rows.