# List markets for a country.

`GET /market_report`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-market-report · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetMarketReport` · Tag: Market Reports

Returns all active Wheelhouse markets which the authenticated user has at least one Pro tier listing in for the given country.

Each market includes the postal codes it covers.

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/market_report`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Read-only keys can call this endpoint.

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `country_code` | string | yes | ISO-3166 2-letter country code (e.g. `US`, `GB`). |

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/market_report?country_code=<country_code>' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

Array of markets.

Body (`application/json`): array of object

- `market_id` (integer): The Wheelhouse internal market ID.
- `market_name` (string): The display name of the market.
- `postal_codes` (array of object): Postal codes covered by this market.
  - `code` (string): The postal code.
  - `latlong` (string): Latitude/longitude of the postal code centroid.

Example shape (generated from the schema; placeholder values, not a real response):

```json
[
  {
    "market_id": 0,
    "market_name": "string",
    "postal_codes": [
      {
        "code": "string",
        "latlong": "string"
      }
    ]
  }
]
```

### 401

API key authorization failed.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
