# French Cadastral Parcel

Identifies French cadastral parcels by address point or cadastral municipality/section/number and returns official IGN geometry.

## Endpoint

- Method: `POST`
- URL: `https://api.helpmyagent.com/v1/real-estate/fr/parcel`
- Price: `0.010 USD` / call

## Machine discovery

- llms.txt: https://helpmyagent.com/llms.txt
- OpenAPI 3.1: https://api.helpmyagent.com/openapi.json
- capabilities.json: https://helpmyagent.com/capabilities.json
- MCP: https://helpmyagent.com/mcp
- RFC 9727: https://helpmyagent.com/.well-known/api-catalog
- pricing.json: https://helpmyagent.com/pricing.json
- x402: https://helpmyagent.com/.well-known/x402
- x402-service.json: https://helpmyagent.com/.well-known/x402-service.json
- Health status: https://helpmyagent.com/health

## x402 payment methods

- USDC on `eip155:8453`
- RLUSD on `xrpl:0`

## Coverage

FR

## Use when

- Identify a French cadastral parcel and retrieve its geometry.

## Avoid when

- Do not treat this as a legally opposable property-title document.

## Limitations

- Address search intersects the geocoded point with cadastral geometry and can return multiple parcels on a parcel boundary.

## Example queries

- Find the cadastral parcel at this French address.

## Freshness

```json
{
    "mode": "source_dependent"
}
```

## Sources

- [API Carto IGN - Cadastre](https://apicarto.ign.fr/api/cadastre/parcelle)
- [API Géoplateforme - Géocodage (BAN/IGN)](https://data.geopf.fr/geocodage/search)

## Input schema

```json
{
    "type": "object",
    "properties": {
        "address": {
            "type": "string",
            "minLength": 5,
            "maxLength": 250,
            "description": "Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250)."
        },
        "code_insee": {
            "type": "string",
            "pattern": "^(?:[0-9]{5}|2[ABab][0-9]{3})$",
            "description": "Optional value for “code insee” as defined by this API contract."
        },
        "section": {
            "type": "string",
            "pattern": "^[0-9A-Za-z]{1,2}$",
            "description": "Optional value for “section” as defined by this API contract."
        },
        "numero": {
            "type": [
                "string",
                "integer"
            ],
            "description": "Optional value for “numero” as defined by this API contract."
        }
    },
    "anyOf": [
        {
            "required": [
                "address"
            ]
        },
        {
            "required": [
                "code_insee",
                "section",
                "numero"
            ]
        }
    ],
    "additionalProperties": false,
    "description": "Structured input parameters for the real-estate/fr/parcel API."
}
```

## Output schema

```json
{
    "type": "object",
    "properties": {
        "location": {
            "type": "object",
            "properties": {
                "code_insee": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “code insee” as defined by this API contract."
                },
                "address": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “address” as defined by this API contract."
                },
                "normalized_address": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “normalized address” as defined by this API contract."
                },
                "postcode": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “postcode” as defined by this API contract."
                },
                "city": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “city” as defined by this API contract."
                },
                "ban_id": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "description": "Structured value returned for “ban id” as defined by this API contract."
                },
                "geocoding_score": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “geocoding score” as defined by this API contract."
                },
                "longitude": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “longitude” as defined by this API contract."
                },
                "latitude": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ],
                    "description": "Structured value returned for “latitude” as defined by this API contract."
                }
            },
            "required": [
                "code_insee",
                "address",
                "normalized_address",
                "postcode",
                "city",
                "ban_id",
                "geocoding_score",
                "longitude",
                "latitude"
            ],
            "additionalProperties": false,
            "description": "Structured value returned for “location” as defined by this API contract."
        },
        "source_status": {
            "type": "string",
            "enum": [
                "ok"
            ],
            "description": "Availability status of the relevant upstream public source. (allowed values: ok)."
        },
        "total_count": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Total number of matching records reported by the source or endpoint."
        },
        "parcels": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “id” as defined by this API contract."
                    },
                    "code_insee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “code insee” as defined by this API contract."
                    },
                    "section": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “section” as defined by this API contract."
                    },
                    "numero": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “numero” as defined by this API contract."
                    },
                    "commune": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “commune” as defined by this API contract."
                    },
                    "feuille": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Structured value returned for “feuille” as defined by this API contract."
                    },
                    "geometry": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "description": "Structured value returned for “geometry” as defined by this API contract."
                    }
                },
                "required": [
                    "id",
                    "code_insee",
                    "section",
                    "numero",
                    "commune",
                    "feuille",
                    "geometry"
                ],
                "additionalProperties": false
            },
            "description": "Structured value returned for “parcels” as defined by this API contract."
        },
        "bbox": {
            "type": [
                "array",
                "null"
            ],
            "items": {
                "type": "number"
            },
            "description": "Structured value returned for “bbox” as defined by this API contract."
        },
        "generated_at": {
            "type": "string",
            "description": "UTC timestamp at which this derived result was generated."
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Known interpretation, source-coverage or freshness limitations for this result."
        }
    },
    "required": [
        "location",
        "source_status",
        "total_count",
        "parcels",
        "bbox",
        "generated_at"
    ],
    "additionalProperties": false,
    "description": "Structured result returned by the real-estate/fr/parcel API."
}
```

## Request example

```json
{
    "address": "10 rue de la Paix 75002 Paris"
}
```

## Billing policy

```json
{
    "charge_on": "valid_result",
    "no_charge_on_empty_result": true,
    "no_charge_on_error": true
}
```