# Condos.ca Agent API Documentation

<p><strong>Condos.ca Agent API</strong> returns the public profile of one agent: biography, title, languages, brokerage, service areas, social links, testimonials and past sales. Pass the agent <code>url</code> from a listing or an agent search item. If the profile page is unavailable, the response holds the public card from the agent search. Email addresses and phone numbers are never returned. Failed requests are not billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `url` | string | Yes | Required. The url of an agent, for example condo-pros/magda-smith. A full profile address works too. |

## Example response

```json
{
    "data": {
        "agent": {
            "id": 233,
            "bio": null,
            "url": "https://condos.ca/condo-pros/magda-smith",
            "name": "Magda Smith",
            "areas": [
                {
                    "url": "https://condos.ca/toronto",
                    "name": "Toronto"
                }
            ],
            "title": "Broker",
            "social": [],
            "subtitle": null,
            "brokerage": "Property.ca Inc., Brokerage",
            "education": null,
            "languages": [],
            "last_name": "Smith",
            "first_name": "Magda",
            "testimonials": [],
            "profile_image": "https://shared-s3.property.ca/public/images/agents/233/233-normal-1.jpg",
            "favourite_quote": null,
            "archive_listings": [
                {
                    "url": "https://condos.ca/toronto/the-maxus-80-cumberland-st/unit-1507-C4424884",
                    "offer": "Sale",
                    "title": "1507 - 80 Cumberland St",
                    "status": "Sold",
                    "bedrooms": 1,
                    "end_date": "2019-04-29",
                    "bathrooms": 2,
                    "mls_number": "C4424884",
                    "asking_price": 799900,
                    "closed_price": 882000
                },
                {
                    "url": "https://condos.ca/toronto/the-bartholomew-downtown-east-200-sackville-st/unit-601-C4332849",
                    "offer": "Sale",
                    "title": "601 - 200 Sackville St",
                    "status": "Sold",
                    "bedrooms": 1,
                    "end_date": "2019-01-20",
                    "bathrooms": 2,
                    "mls_number": "C4332849",
                    "asking_price": 579900,
                    "closed_price": 565000
                }
            ]
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | No agent has this url. 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)