# Immobilier Notaires Agency Profile API Documentation

Scrappa's `GET /api/notaires-immo/agency` returns the profile of a notary office: name, SIREN, SIRET, address, website, department and the services it offers (sales, rentals, auctions, valuation).

Use `agency_id` from search or listing as `crpcen`. To list the listings of one office, call `search` with the same `crpcen`. The office name lists the notaries as the public site shows them.

- **Documentation:** [https://scrappa.co/docs/notaires-immo-api/notaires_immo_agency](https://scrappa.co/docs/notaires-immo-api/notaires_immo_agency)
- **API group:** Immobilier Notaires API
- **Endpoint:** `GET https://scrappa.co/api/notaires-immo/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 |
| --- | --- | --- | --- |
| `crpcen` | string | Yes | Notary office id (agency_id in search results). |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/notaires-immo/agency?crpcen=94026"
```

## Example response

```json
{
    "success": true,
    "agency": {
        "agency_id": "94026",
        "office_id": 4246,
        "name": "Julien CELLARD, Pierre CELLARD et Evelyne CELLARD",
        "siren": "491556973",
        "siret": "49155697300015",
        "website": "notaire-cellard-saint-mande-paris.notaires.fr",
        "street": "3 AVENUE FOCH",
        "postal_code": "94160",
        "city": "SAINT-MAND\u00c9",
        "department_code": "94",
        "department": "VAL DE MARNE",
        "services": {
            "sales": true,
            "rentals": true,
            "auctions": true,
            "valuation": false
        }
    },
    "meta": {
        "endpoint_family": "agency_profile",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Immobilier Notaires has no office for this id (`not_found`). The listing may be sold or removed. Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters are rejected with `unsupported_filter`, never ignored. There is no bathroom or new-build filter. Non-billable. |
| 503 | Upstream Unavailable | Immobilier Notaires could not be reached after retries, blocked the request, returned another page than asked for, or returned data this API could not read (`upstream_unavailable`, `upstream_blocked`, `page_mismatch`, `parser_drift`, `no_exit_available`). Retryable and never billed. Clients are never rate limited. |

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