Logistics engineer · PropTech · Risk analyst
Every postcode in your zone, enriched, in one call.
Assessing flood exposure across a service area, checking rural/urban mix inside a delivery radius, or researching property values within walking distance of a development site all require the same thing: the full signal set for every postcode in a zone. The /within endpoint returns them ordered by distance — no postcode list to maintain, no loop of individual lookups, no joins.
Relevant signals
These fields are returned on every response and are ready to wire into your application logic.
| Signal | Relevance | What it tells you |
|---|---|---|
| queryPointDistanceMetres | Critical | Distance in metres from your query point to the postcode centroid. Results are returned in ascending order, so the closest postcodes appear first. |
| signals.flood.riversSea | Critical | Environment Agency flood risk band for rivers and sea. Aggregate across results to understand overall flood exposure in your zone. |
| signals.crime.rateBand | High | National crime rate band (very_low → very_high). Scan across all postcodes in a radius to identify elevated-risk pockets within a zone. |
| ruralUrbanClassification | High | Five-tier ONS classification. Check the rural/urban mix across a delivery catchment or service area in one call. |
| signals.property.averagePrice | High | HMLR median transaction price. Profile the property wealth distribution across a neighbourhood or investment target area. |
| signals.deprivation.imdDecile | Medium | ONS Index of Multiple Deprivation decile (1 = most deprived). Map deprivation gradient across a zone for site selection or ESG reporting. |
| signals.broadband.gigabit | Medium | Ofcom gigabit broadband availability flag. Useful for infrastructure planning or identifying connectivity gaps within a radius. |
Live example
A real-world request and the response it returns.
Request
curl "https://api.zyfy.uk/v1/postcode/within?lat=51.5074&lon=-0.1278&radius=500" \
-H "X-API-Key: your_api_key"Response
{
"total": 4,
"results": [
{
"postcode": "WC2N 5DU",
"queryPointDistanceMetres": 183.4,
"latitude": 51.5083,
"longitude": -0.1257,
"country": "England",
"region": "London",
"adminDistrict": "City of Westminster",
"ruralUrbanClassification": "urban_major_conurbation",
"summary": { "propertyRiskLevel": "low", "liveabilityLevel": "high" },
"signals": {
"flood": { "riversSea": "very_low", "surfaceWater": "low" },
"crime": { "rateBand": "high" },
"broadband": { "gigabit": true, "medianDownloadMbps": 516 }
/* ... full signal set ... */
}
},
{
"postcode": "SW1A 2AA",
"queryPointDistanceMetres": 312.1
/* ... full signal set ... */
},
{
"postcode": "WC2N 4HZ",
"queryPointDistanceMetres": 394.7
/* ... full signal set ... */
},
{
"postcode": "SW1A 1AA",
"queryPointDistanceMetres": 487.9
/* ... full signal set ... */
}
],
"quota": { "remaining": 9996, "limit": 10000, "resetAt": "2026-07-01T00:00:00Z" }
}Example data is illustrative only. Responses shown include a subset of signals for clarity — the full response contains additional fields. See the signal reference for the complete list.
What you get
- ✓ No postcode list to maintain — Pass a coordinate and radius — the API resolves every postcode centroid within the area. No ONSPD to download, no periodic refresh, no list of postcodes to keep current.
- ✓ Full signal set per result — Each postcode in results[] carries the complete signal set — flood risk, crime band, property price, deprivation, broadband, demographics, and all derived scores. The same shape as a single postcode lookup.
- ✓ Distance-ordered results — Results are sorted by queryPointDistanceMetres ascending so the nearest postcodes appear first — useful for nearest-neighbour analysis or distance-banded reporting.
- ✓ Quota that scales with your use — Each postcode returned costs one quota unit — the same as an individual lookup. A call returning 10 postcodes costs 10 units. You only pay for what comes back, capped at your plan's bulk limit.
Zone intelligence in one call, no list required.
Free tier includes 100 requests per month. No credit card, no sales call.