canonical: https://jentic.com/apis/propeco.io/propeco

# PropEco Flood Risk API

Retrieves flood risk information for UK properties and locations, including risk assessments for England, Scotland, and Wales, elevation data, coastal proximity, flood defences, and historical flood events. The API exposes 1 endpoints secured with apiKey authentication.

## For AI agents

Programmatically get flood risk data. Covers 1 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for maps and geolocation only.

## Capabilities

- Get flood risk data
- Access PropEco Flood Risk API resources via REST API
- Access PropEco Flood Risk API resources via REST API

## Use cases

### Maps and Geolocation Operations

Use the PropEco Flood Risk API to perform maps geolocation operations programmatically. The API provides 1 endpoints covering core functionality including get flood risk data.

Example prompt: Call GET /flood-risk to get flood risk data

### Data Retrieval and Monitoring

Query PropEco Flood Risk API endpoints to retrieve structured data for monitoring, reporting, or downstream processing. The API returns JSON responses that agents can parse directly, enabling automated data collection workflows without manual intervention.

Example prompt: Query the PropEco Flood Risk API API to retrieve current data and verify the response contains expected fields

### AI Agent Integration via Jentic

AI agents discover and call PropEco Flood Risk API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'get flood risk data', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/flood-risk` | Get flood risk data |

## Key resources

- **Flood Risk** — Operations for flood risk

## Why Jentic

- **Setup:** Wiring the PropEco Flood Risk API by hand means passing your key in the x-api-key header and parsing its flood-risk response yourself. Through Jentic you install once, import PropEco from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The PropEco Flood Risk API exposes a single read operation (GET /flood-risk) with no resource id in the path, so you limit the agent to the operations it needs, such as retrieving flood risk for a location. That read is the whole surface, and you decide it is the only thing the agent may call.
- **Credential handling:** Your PropEco Flood Risk API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get flood risk for an address', and Jentic returns the matching PropEco operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Here** — Alternative maps geolocation API
- **Tomtom** — Alternative maps geolocation API
- **Googleapis** — Complementary maps geolocation API

## FAQ

### What authentication does the PropEco Flood Risk API use?

The PropEco Flood Risk API uses an API key passed in the `x-api-key` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I get flood risk data with the PropEco Flood Risk API?

Yes. Use the GET /flood-risk endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the PropEco Flood Risk API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I get flood risk data through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'get flood risk data'. Jentic returns the matching PropEco Flood Risk API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the PropEco Flood Risk API have?

The PropEco Flood Risk API exposes 1 endpoints covering flood risk operations.

### Can I limit what my agent is allowed to do with the PropEco Flood Risk API?

Yes. Jentic One is self-hosted, so you run it and your own rules decide which operations and credentials the agent may use. The PropEco Flood Risk API exposes a single read operation, GET /flood-risk, with no resource id in the path, so you can allow only that call for retrieving flood risk at a location and nothing else. Since that read is the entire surface, the agent can query flood risk data but cannot reach any operation you have not permitted.