# 99.co Agent Profile API Documentation

Read one agent profile by the CEA registration number from /agents: name, job title, description, phone, photo, agency with licence number, the listing breakdown by sale or rent, category, district and development, and the areas of expertise. The e-mail address is never returned. An unknown CEA number is a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/99co-api/99co_agent](https://scrappa.co/docs/99co-api/99co_agent)
- **API group:** 99.co API
- **Endpoint:** `GET https://scrappa.co/api/99co/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 |
| --- | --- | --- | --- |
| `cea_number` | string | Yes | CEA registration number: one letter, six digits, one letter. Example: R025639D. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/99co/v1/agent?cea_number=R025639D"
```

## Example response

```json
{
    "success": true,
    "data": {
        "cea_number": "R025639D",
        "name": "Agent Name",
        "job_title": null,
        "description": "Agent Name is a licensed and certified property agent under ERA REALTY NETWORK PTE LTD in Singapore.",
        "phone": "+6560000000",
        "phone_masked": "+656000XXXX",
        "photo_url": "https://pic2.99.co/v3/oKbYexp8M3oStjoARatB4H?mode=fill",
        "agency": {
            "licence_number": "L3002382K",
            "name": "ERA REALTY NETWORK PTE LTD",
            "photo_url": "https://pic2.99.co/v2/aWXk2ZVKzwiv4Bmdru3YCn?mode=fill"
        },
        "listings_breakdown": {
            "total": 4,
            "sale_rent": [
                {
                    "key": "Sale",
                    "count": 3
                },
                {
                    "key": "Rent",
                    "count": 1
                }
            ],
            "main_category": [
                {
                    "key": "Condo",
                    "count": 3
                }
            ],
            "district": [
                {
                    "key": "District 19",
                    "count": 2
                }
            ],
            "development": [
                {
                    "key": "Midtown Residences",
                    "count": 1
                }
            ]
        },
        "area_expertise": [],
        "is_free_agent": false,
        "is_corporate": false,
        "profile_url": "https://www.99.co/singapore/agents/R025639D-agent-name"
    },
    "meta": {
        "endpoint_family": "agent",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter is missing or invalid. No upstream call is made and the response is not billable. |
| 404 | Resource Not Found | The requested 99.co resource does not exist. The response is not billable. |
| 502 | Unexpected Upstream Response | 99.co answered with a body that is not the documented shape. The response is not billable. |
| 503 | Upstream Unavailable | 99.co was temporarily unavailable or blocked the request. The response is not billable and the request never answers 429. |

## 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)