# Zameen Agency Agents API Documentation

<p><strong>Zameen Agency Agents API</strong> Get the public agency page of an agency: owner, address, website, city, offices, the agents with name, designation, photo and mobile number as published, and the listing counts by purpose and type. E-mail addresses are never returned. The data comes from one call to the public agency page.</p>

- **Documentation:** [https://scrappa.co/docs/zameen-api/zameen_agency_agents](https://scrappa.co/docs/zameen-api/zameen_agency_agents)
- **API group:** Zameen API
- **Endpoint:** `GET https://scrappa.co/api/zameen/agency/agents`

## 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 | Agency id, e.g. 190203. Returns the public agency page data: owner, offices, agents and listing counts. |

## Example response

```json
{
    "data": {
        "id": "190203",
        "city": "Karachi",
        "logo": "https://zameen-images-live.s3-eu-west-1.amazonaws.com/agency_logo/90a5a24c-9ad9-43fd-9452-e74048a3b589/thumbnail.jpg",
        "name": "Ali Estate",
        "owner": {
            "name": "Ali Abbas Noorani",
            "photo": "https://zameen-images-live.s3-eu-west-1.amazonaws.com/user_profile/5a373fff-b3ed-44ee-ba98-fbd887dffd02/thumbnail.jpg",
            "designation": "Supervisor"
        },
        "phone": null,
        "agents": [
            {
                "id": "1001142870",
                "name": "Ali Abbas Noorani",
                "photo": "https://zameen-images-live.s3-eu-west-1.amazonaws.com/user_profile/5a373fff-b3ed-44ee-ba98-fbd887dffd02/thumbnail.jpg",
                "mobile": "+923000000000",
                "designation": "Supervisor"
            },
            {
                "id": "1001676120",
                "name": "Mohsin Ali",
                "photo": null,
                "mobile": "+923000000000",
                "designation": null
            }
        ],
        "mobile": "+923000000000",
        "address": "C-63, Block 4, Opposite Bank Al Habib, Saadi Town, Scheme 33, Karachi.",
        "offices": [],
        "website": null,
        "whatsapp": "+923000000000",
        "listing_counts": {
            "rent": {
                "total": 12,
                "types": [
                    {
                        "type": "Lower Portions",
                        "count": 5
                    },
                    {
                        "type": "Houses",
                        "count": 4
                    },
                    {
                        "type": "Upper Portions",
                        "count": 2
                    },
                    {
                        "type": "Flats",
                        "count": 1
                    }
                ]
            },
            "sale": {
                "total": 46,
                "types": [
                    {
                        "type": "Houses",
                        "count": 43
                    },
                    {
                        "type": "Flats",
                        "count": 3
                    }
                ]
            }
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency_agents"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter is missing or invalid. This response is not billable. |
| 404 | Agency Not Found | The agency id does not exist. This response is not billable. |
| 503 | Temporarily Unavailable | Zameen did not answer or refused the request after several attempts. This response is not billable. Retry after a short pause. |

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