# Rumah123 Agent API Documentation

<p><strong>Rumah123 Agent API</strong> returns one agent profile: name, profile URL, office address, description, verification flag, languages, property specialities, the number of active, sale and rented listings, the agency and the profile photo. Phone numbers, e-mail addresses and user names are private and are never returned. The agent id comes from a listing or from the agent directory. An unknown id gives a 404 that is not billed.</p>

- **Documentation:** [https://scrappa.co/docs/rumah123-api/rumah123_agent](https://scrappa.co/docs/rumah123-api/rumah123_agent)
- **API group:** Rumah123 API
- **Endpoint:** `GET https://scrappa.co/api/rumah123/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 from a listing or the agent directory. Example: 2079552. |

## Example response

```json
{
    "data": {
        "id": "2079552",
        "url": "https://www.rumah123.com/en/property-agent/housid/salwa-housid-2079552/",
        "name": "Salwa HousID",
        "uuid": "3a0367a4-4aa4-4871-b333-62a1bc728c22",
        "images": [
            "https://pic.rumah123.com/r123/250x250-fit/photo/2079552/180/20795521756817088.jpg"
        ],
        "address": "No. 9 A, Jl. Tebet Barat IX, Tebet Bar., Kec. Tebet, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12810",
        "languages": [
            "others"
        ],
        "specialist": [
            "rumah",
            "tanah"
        ],
        "description": "Agent Property Spesialis Tebet & Jakarta Selatan",
        "is_verified": true,
        "organization": {
            "id": "136746",
            "url": "https://www.rumah123.com/en/property-agent/housid-136746/",
            "name": "HOUSID",
            "uuid": "43a8f67a-c2ef-4955-8edd-24c8c2f8fe72"
        },
        "listing_stats": {
            "sale": 28,
            "active": 162,
            "rented": 0
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter 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 | Rumah123 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)