# Boligsiden Agency API Documentation

<p><strong>Boligsiden Agency API Documentation</strong> Retrieve one real estate agency by id: name, branch chain, contact data, CVR number, description, logo, number of employees and agents, memberships, buyer and seller ratings with the question scores, active listings for sale, cooperative and rent, sales percentages and market statistics by area.</p>

- **Documentation:** [https://scrappa.co/docs/boligsiden-api/boligsiden_agency](https://scrappa.co/docs/boligsiden-api/boligsiden_agency)
- **API group:** Boligsiden API
- **Endpoint:** `GET https://scrappa.co/api/boligsiden/agency`

## 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 UUID from a search result (field realtor.id). Example: 40a5602f-7d06-4f58-9f82-c1ab96a3cb28 |

## Example response

```json
{
    "data": {
        "agency": {
            "id": "40a5602f-7d06-4f58-9f82-c1ab96a3cb28",
            "cvr": "40676988",
            "url": "https://www.danbolig.dk/ejendomsmaegler/oesterbro",
            "name": "danbolig \u00d8sterbro & Nordhavn",
            "slug": "danbolig-oesterbro---nordhavn-ndr.-frihavnsgade-86-2100-koebenhavn-oe-40a5602f7d064f589f82c1ab96a3cb28",
            "email": "oesterbro@danbolig.dk",
            "phone": "70272100",
            "stats": {
                "open": {
                    "all": [
                        {
                            "price": 13995000,
                            "amount": 1,
                            "status": "open",
                            "addressType": "terraced house",
                            "perAreaPrice": 73891,
                            "timeOnMarket": 124,
                            "presaleAmount": 0,
                            "priceChangePercentage": 0
                        }
                    ]
                }
            },
            "rating": {
                "buyer": {
                    "score": 8.92,
                    "responses": 12
                },
                "seller": {
                    "score": 9.49,
                    "responses": 35
                }
            },
            "address": {
                "city": "K\u00f8benhavn \u00d8",
                "road": "Ndr. Frihavnsgade",
                "floor": "st",
                "zip_code": 2100,
                "house_number": "86"
            },
            "realtors": 7,
            "employees": 10,
            "image_url": "https://images.boligsiden.dk/images/realtor_image/40a5602f-7d06-4f58-9f82-c1ab96a3cb28/1440x960/c0444a68-a284-43d3-ad55-57ed8675e891.webp?h=005721f22075a7b5ca29961537bf187913f2ed8c6272f98c5b10e9a84e4da693",
            "created_at": "2019-11-26",
            "branch_name": "danbolig",
            "description": "Hos danbolig \u00d8sterbro kan du forvente et professionelt, dedikeret og empatisk hold af medarbejdere, der sikrer dig et tr...",
            "member_of_elo": false,
            "active_listings": {
                "for_rent": 0,
                "for_sale": 56,
                "cooperative": 0
            },
            "branch_logo_url": "https://images.boligsiden.dk/images/realtor_branch/e4431355-6722-440b-ab75-52067eacef26/60x40/390fe9bb-dff9-4e9a-96f1-03115829b86a.gif?h=bab8f2057430054f57b8fabb83bb4e15bd42d03f81ff365ceedcab8e87fa4187",
            "rating_questions": {
                "buyer": {
                    "questions": [
                        {
                            "text": "I hvilken grad var salgsmaterialet (salgsopstilling, pr\u00e6sentation p\u00e5 nettet mv.) d\u00e6kkende for boligen?",
                            "scores": {
                                "realtor": {
                                    "basis": 12,
                                    "score": 8.83,
                                    "state": "valid"
                                },
                                "province": {
                                    "basis": 752,
                                    "score": 8.27
                                }
                            }
                        }
                    ]
                }
            },
            "description_title": "Velkommen hos danbolig \u00d8sterbro & Nordhavn",
            "sales_percentages": {
                "all": [
                    {
                        "addressType": "condo",
                        "salesPercentage": 87.69
                    }
                ]
            },
            "broadcast_percentage": 86.7,
            "member_of_danish_realtors": true
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "realtor_detail"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. No upstream request is made. This response is not billable. |
| 404 | Not Found | No Boligsiden agency exists for the requested id. This response is not billable and is not retried. |
| 503 | Service Unavailable | Boligsiden could not be reached, blocked or rate limited every attempt, or answered with a shape that no longer matches the documented contract. Retry shortly. This response is not billable. |

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