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

# Fetch details about a specific Market.

`GET /market/{marketId}`

## Request

- Base URL: `https://api.airdna.co/api/enterprise/v2`
- URL: `https://api.airdna.co/api/enterprise/v2/market/{marketId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/airdna/apis/airdna-enterprise-api/docs/market/:marketId/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/airdna/apis/airdna-enterprise-api.md) - [All operations](https://skmtc.dev/airdna/apis/airdna-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/airdna/apis/airdna-enterprise-api/revisions/aeed3678926f?raw)