---
title: "Fetch details about a specific Market."
method: GET
path: "/market/{marketId}"
tags: ["market_data"]
---

# Fetch details about a specific Market.

`GET /market/{marketId}`

Provides basic information about a specific Market. Includes key data such as:
* Summary Metrics (**Last 12 Months**)
  * **Market Score**
  * **Occupancy**
  * **Revenue**
  * **RevPAR**

## Path parameters

- `marketId` string, required — AirDNA ID for the Market. This can often be found as `market_id`.

## Response `200`

Successful Market Details Response

- object
  - `payload` Market, required — General Information about a Market.
    - `id` string, required — Unique ID to identify the Market.
    - `name` string, required — Name of the Market.
    - `market_type` 'urban_metro' | 'mountains_lakes' | 'coastal' | 'suburban' | 'rural' | 'mid_size_city', required — The type of the Market/Submarket.
    - `images` string[], required — List of image URLs representing the Market.
    - `metrics` MarketMetrics, required — Provides a high-level performance summary of the Listings within a Market/Submarket.
      - `market_score` number, required — Score based on how the Market/Submarket has performed across demand, revenue growth, seasonality and regulation.
      - `revenue` number, required — Average Revenue for a Listing within the Market/Submarket. * Calculated based on the Listings that meet the requested `filters`. * Calculated based on data from the **Last 12 Months**
      - `booked` number, required — Percentage representing how often the Listings in the Market/Submarket have been booked against their availability. * Expressed as a decimal value from 0.0 to 1.0. * Calculated based on the Listings that meet the requested `filters`. * Calculated based on data from the **Last 12 Months**
      - `daily_rate` number, required — The average daily booking rate for the Listings in the Market/Submarket. * Calculated based on the Listings that meet the requested `filters`. * Calculated based on data from the **Last 12 Months**
      - `revpar` number, nullable, required — The RevPAR (Revenue Per Available Rental) for the Listings in the Market/Submarket. * Calculated based on the Listings that meet the requested `filters`. * Calculated based on data from the **Last 12 Months**
    - `geospatial` GeoSpatial, required — The geographical location of the data.
      - `geom` Geom
        - `MultiPolygon` object — GeoJson Mulipolygon
          - `coordinates` array[], required
            - object[]
              - …
      - `geom_pt` GeomPoint — ISO 6709 Coordinates.
        - `lat` number, required — ISO 6709 Latitude coordinate.
        - `lng` number, required — ISO 6709 Longitude coordinate.
  - `status` Status, required — The Status object on the response envelope
    - `type` 'success' | 'error', required — The type of response provided by the server.
    - `response_id` string, required — A unique response code that can be used as a reference for support requests.
    - `message` string, required — A human-readable message that can provide more detail about the status of the request.

## Other responses

- `400` — The request was invalid.
- `404` — Failed to find data matching your request.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/airdna/apis/airdna-enterprise-api.md) · [All operations](https://skmtc.net/airdna/apis/airdna-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airdna/airdna-enterprise-api/versions/aeed3678926f/schema)