# Create a new CMA

**GET /cmas/new**

Create a new Comparative Market Analysis report with one or more MLS listings. Can be initiated directly from an MLS site or broker website.


## Servers
- Production API: https://cloudcma.com (Production API)


## Authentication methods
- Api key


## Parameters


### Query parameters

- **mlsnums** (string)
  Comma-separated list of MLS numbers for subject properties in the CMA

- **address** (string)
  Single address for the subject property. Used for geocoding to set proximity search area.

- **title** (string)
  Title for the CMA report. User can edit in Cloud CMA if not provided.

- **notes** (string)
  Internal notes for the report. Agents see these, consumers do not.

- **beds** (integer)
  Bedrooms of subject property. Used to filter comparable properties.

- **baths** (number)
  Bathrooms of subject property. Used to filter comparable properties.

- **sqft** (integer)
  Square feet of subject property. Used to filter comparable properties.

- **prop_type** (string)
  Property type for proximity search filter (e.g., RES, Commercial). Must match MLS RETS metadata.

- **min_listings** (integer)
  Minimum number of comparable listings to include. Default varies by MLS.

- **lat** (number(double))
  Override geocoded latitude for proximity search center point

- **lon** (number(double))
  Override geocoded longitude for proximity search center point

- **callback_url** (string(uri))
  Webhook URL for report status updates. See Webhooks section.



## Responses
### 302
Redirect to Cloud CMA report creation page. User logged in → goes directly to new CMA. User not logged in → sent to login first.

### 400
Invalid parameters (e.g., invalid MLS numbers, address outside MLS boundary)


[Powered by Bump.sh](https://bump.sh)