# iProperty Agent API Documentation

<p><strong>iProperty Agent API</strong> returns the public profile of one property agent as JSON: name, REN license, verified flag, photo, agency with license and logo, about text, rating, review count, transaction count, languages and public social links. The rating is null while the agent has no reviews. Phone numbers and messaging links are never returned. To list the active listings of an agent, call Search with <code>agent_id</code>.</p>

- **Documentation:** [https://scrappa.co/docs/iproperty-api/iproperty_agent](https://scrappa.co/docs/iproperty-api/iproperty_agent)
- **API group:** iProperty API
- **Endpoint:** `GET https://scrappa.co/api/iproperty/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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Agent id, digits only (from a search or listing result). Example: 2671558. |
| `slug` | string | No | Optional profile slug, lowercase letters, digits and hyphens. Example: kevin-ooi. |

## Example response

```json
{
    "data": {
        "id": 2671558,
        "url": "https://iproperty.com.my/property-agent/kevin-ooi-2671558",
        "name": "Kevin Ooi",
        "about": "A registered agent with us, here to help with your property needs.",
        "photo": null,
        "agency": {
            "logo": "https://img.iproperty.com.my/my-iproperty-original/5u86c59513c6-6903-4fd4-8174-883404e345d4_124x36.png",
            "name": "MCENTURY PROPERTIES SDN BHD [ E (1) 1862 ]",
            "license": "E (1) 1862"
        },
        "rating": null,
        "license": "REN80099",
        "verified": true,
        "languages": [],
        "review_count": 0,
        "social_links": [],
        "transaction_count": 0
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter, a value or a range is invalid. This response is not billable. |
| 404 | Not Found | The agent does not exist. This response is not billable. |
| 503 | Upstream Unavailable | iProperty could not be reached or returned data that does not match the request. 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)