# Mudah.my Property Agent API Documentation

<p><strong>Mudah.my Property Agent API</strong> returns an agent or agency profile by slug: name, company, verification, description, website, public phone, address, active listing count, member since date, logo, storefront image, registration numbers, firm type, specialties and store hours. Use <code>seller.profile_slug</code> from the listing endpoint. Private sellers return only counts and dates. Email addresses and private account fields are never returned. The response includes the <code>user_id</code> for the seller listings endpoint.</p>

- **Documentation:** [https://scrappa.co/docs/mudah-property-api/mudah_property_agent](https://scrappa.co/docs/mudah-property-api/mudah_property_agent)
- **API group:** Mudah.my Property API
- **Endpoint:** `GET https://scrappa.co/api/mudah-property/v1/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 |
| --- | --- | --- | --- |
| `slug` | string | Yes | Profile slug in lowercase letters, digits and hyphens. Example: mjzairin. |

## Example response

```json
{
    "data": {
        "logo": "https://cdn.rnudah.com/image_logo/plain/f8b450740441eac3b4479724bf99b651-2973258161355603778.jpg",
        "name": "M.J. Zairin",
        "type": "agent",
        "about": "Jual, beli dan sewa segala bentuk Hartanah di sekitar Kuala Lumpur dan Lembah Klang (Selangor).",
        "phone": "0120000000",
        "status": "active",
        "address": {
            "city": "Ampang",
            "line1": "A9-4-4 Jln AU 2/2",
            "line2": "One Ampang Buss Avenue",
            "state": "Selangor",
            "region": "Selangor",
            "postcode": "68000"
        },
        "user_id": 6690932,
        "website": "http://www.azmico.com.my",
        "headline": "Perunding Hartanah Berdaftar",
        "store_id": 790734,
        "verified": true,
        "profile_url": "https://www.mudah.my/mjzairin",
        "store_hours": null,
        "company_name": "Azmi Real Estate Agency Sdn Bhd",
        "member_since": "2017-10-01T00:00:00+08:00",
        "specialty_ids": [
            "1",
            "2"
        ],
        "storefront_image": "https://cdn.rnudah.com/image_store_front/plain/172060cb97c2b141456c4790be4c2361-2967100248175479100.jpg",
        "agent_registration": {
            "number": "32537",
            "firm_type": "e",
            "firm_number": "12072",
            "identity_type": "ren"
        },
        "active_property_count": 314,
        "specialty_subarea_ids": [
            "268",
            "281"
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | The requested resource does not exist or was removed. This response is not billable. |
| 503 | Upstream Unavailable | Mudah.my could not be reached. This response is not billable and is retryable. |
| 503 | Unexpected Upstream Data | Mudah.my returned data in an unexpected shape. 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)