# Condos.ca Listing API Documentation

<p><strong>Condos.ca Listing API</strong> returns one active listing by MLS number: price, maintenance fee, fees included, size, rooms, address with postal code, coordinates, description, amenities, photos, open houses, building and listing agent. One billable request makes two upstream fetches. If the detail page is unavailable, the response still holds the search data and <code>detail_available</code> is <code>false</code>. A sold or expired MLS number returns 404. Agent contact details are never returned. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/condos-ca-api/condos_ca_listing](https://scrappa.co/docs/condos-ca-api/condos_ca_listing)
- **API group:** Condos.ca API
- **Endpoint:** `GET https://scrappa.co/api/condos-ca/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `mls_number` | string | Yes | Required. The mls_number of a search item. Example: W14100176. |

## Example response

```json
{
    "data": {
        "listing": {
            "id": 2375394,
            "tax": 2044,
            "url": "https://condos.ca/toronto/mansions-of-humberwood-2-700-humberwood-blvd/unit-219A-W14100176",
            "sqft": {
                "max": 899,
                "min": 800,
                "value": null
            },
            "tags": [
                "High-Rise"
            ],
            "offer": "Sale",
            "price": 500000,
            "rooms": [
                {
                    "type": "Kitchen",
                    "unit": "Meter",
                    "level": "Main",
                    "width": 2.5,
                    "length": 2.6
                },
                {
                    "type": "Living Room",
                    "unit": "Meter",
                    "level": "Main",
                    "width": 3.03,
                    "length": 5.9
                }
            ],
            "title": "219A - 700 Humberwood Boulevard",
            "images": [
                "https://cdn.repliers.io/IMG-W14100176_9ac96acb6a64aa15db7c01bde3aa9adbf8eb57a3057586500596da47f98faac2.jpg",
                "https://cdn.repliers.io/IMG-W14100176_f2f0cdc4dc34caab52815893c3cb94f593d08b102c9aef88c72fb16a37d8308f.jpg"
            ],
            "locker": {
                "type": "Exclusive",
                "has_locker": true
            },
            "medias": [],
            "status": "Active",
            "ad_text": "Spacious corner suite with open balcony and elevated views overlooking natural surroundings. Large windows provide abundant natural light for a bright, welcoming atmosphere. Building amenities include a gym, tennis court, indoor pool, guest suites, and more. Conveniently located near public transit,...",
            "address": {
                "url": "https://condos.ca/toronto/700-humberwood-boulevard-etobicoke",
                "formatted": "700 Humberwood Blvd, Etobicoke, ON",
                "postal_code": "M9W 7J4",
                "street_name": "Humberwood Boulevard",
                "street_number": "700"
            },
            "parking": {
                "type": "Underground",
                "spots": 1
            },
            "bed_type": "2",
            "bedrooms": 2,
            "building": {
                "id": 980,
                "age": "18",
                "url": "https://condos.ca/toronto/mansions-of-humberwood-2-700-humberwood-blvd",
                "name": "Mansions of Humberwood \u2161",
                "photo": "https://shared-s3.property.ca/public/images/buildings/980/mansions-of-humberwood-2-700-humberwood-blvd-normal-1.jpg",
                "address": "700 Humberwood Blvd",
                "age_max": 18,
                "rent_count": 5,
                "sale_count": 7,
                "construction_status": "Complete"
            },
            "estimate": {
                "max": 504022,
                "min": 465460,
                "expected": 485808
            },
            "exposure": "SW",
            "features": {
                "level": 2,
                "style": "Apartment",
                "heat_type": "Forced Air",
                "fronting_on": null,
                "hydro_included": false,
                "water_included": true,
                "ensuite_laundry": true,
                "parking_charges": null,
                "parking_included": true
            },
            "location": {
                "region": {
                    "id": 1,
                    "name": "Toronto Division"
                },
                "street": "Humberwood Boulevard",
                "country": "Canada",
                "latitude": 43.7242481703,
                "locality": {
                    "id": 1,
                    "name": "Toronto"
                },
                "province": {
                    "id": 9,
                    "name": "Ontario"
                },
                "longitude": -79.616236246,
                "sublocality": {
                    "id": 16,
                    "name": "Etobicoke"
                },
                "neighbourhood": {
                    "id": 803,
                    "name": "West Humber | Clairville"
                }
            },
            "sub_type": "Condo Apartment",
            "tax_year": 2025,
            "tour_url": null,
            "amenities": [
                "Concierge",
                "Party Room",
                "Visitor Parking",
                "Guest Suites",
                "Meeting Room"
            ],
            "bathrooms": 1,
            "brokerage": "RE/MAX WEST REALTY INC.",
            "furnished": null,
            "home_type": "Condo",
            "breadcrumb": [
                {
                    "url": "https://condos.ca/toronto",
                    "name": "Toronto",
                    "area_type": "Locality"
                },
                {
                    "url": "https://condos.ca/toronto/etobicoke",
                    "name": "Etobicoke",
                    "area_type": "Sublocality"
                },
                {
                    "url": "https://condos.ca/toronto/west-humber-clairville",
                    "name": "West Humber | Clairville",
                    "area_type": "Neighbourhood"
                }
            ],
            "entry_date": "2026-10-20",
            "mls_number": "W14100176",
            "has_balcony": true,
            "open_houses": [],
            "photo_count": 11,
            "unit_number": "219A",
            "descriptions": {
                "intro": "Located at 219a - 700 Humberwood Boulevard, this Etobicoke condo is available for sale. 219a - 700 Humberwood Boulevard has an asking price of $500000, and has been on the market since October 2026. This condo has 2 beds...",
                "whats_nearby": "700 Humberwood Blvd is a 4-minute walk from Country Style for that morning caffeine fix and if you're not in the mood to cook, Bollywood Blvd, Al Meezan Spicy Grill and Harvey's are near this condo. For grabbing your gro...",
                "getting_around": "Living in this West Humber | Clairville condo is easy. There is also Humberwood Blvd / Kingsplate Cres West Bus Stop, only steps away, with route Islington, and route Finch West nearby. If you need to get on the highway ..."
            },
            "fees_include": [
                "Heat",
                "Parking",
                "Water",
                "Air Conditioning",
                "Common Element",
                "Building Insurance"
            ],
            "bedrooms_plus": null,
            "listing_agent": {
                "id": 923,
                "url": "https://condos.ca/condo-pros/eddie-ardalan",
                "name": "Eddie Ardalan",
                "slug": "condo-pros/eddie-ardalan",
                "title": "Sales Representative",
                "brokerage": "Property.ca Inc., Brokerage",
                "profile_image": "https://shared-s3.property.ca/public/images/agents/923/923-small-683e6dab551ba9.20441511.jpg"
            },
            "outdoor_space": "Balcony, Patio",
            "property_type": "Condo Apt",
            "thumbnail_url": "https://cdn.repliers.io/IMG-W14100176_9ac96acb6a64aa15db7c01bde3aa9adbf8eb57a3057586500596da47f98faac2.jpg?width=640",
            "date_available": "2027-01-31",
            "days_on_market": 6,
            "featured_agent": null,
            "pets_permitted": "Restrict",
            "maintenance_fee": 543.9,
            "detail_available": true
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | No active listing has this MLS number. This response is not billable. |
| 503 | Upstream Unavailable | Condos.ca could not be reached. This response is not billable and is retryable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
