Skip to content

Single location — address query

Send a postal-style address. Geosapiens geocodes it to coordinates, then returns flood hazard and flood risk scores and the wildfire hazard score for that point.

There is no financial or loss data in this Essential endpoint.

Request

HTTP method: POST

Path: /mediator/single_location_address_query

(Your environment may use a different host or path prefix in front of /mediator/… — use the URL you were given.)

Headers

  • Content-Type: application/json
  • Authorization: Bearer <your JWT> — see Authentication

Body example

{
  "location": {
    "streetAddress": "9 101A Ave",
    "city": "Edmonton",
    "areaName": "Alberta",
    "postalCode": "T5H 0B9",
    "countryName": "Canada",
    "wb_window": 5
  }
}

Location fields

Field Required Notes
streetAddress Yes Street number and name
city Yes City or municipality
areaName Yes Province, state, or region
postalCode Yes Postal or ZIP code
countryName Yes Country
unitNumber No Unit or suite (string), if applicable
wb_window No 1, 3, 5, or 7. Default 5. Controls waterbody neighborhood search — see Waterbody search (wb_window).

The Essential schema allows only the location object at the top level (no financial block).

Successful response

The body includes the normal success envelope plus the seven scores listed in Output values.

Example (illustrative numbers only):

{
  "type": "OK",
  "description": "The request has succeeded.",
  "statusCode": 200,
  "fluvialFloodHazardScore": 6,
  "fluvialFloodRiskScore": 4,
  "coastalFloodHazardScore": 1,
  "coastalFloodRiskScore": 0,
  "pluvialFloodHazardScore": 4,
  "pluvialFloodRiskScore": 2,
  "wildfireHazardScore": 8
}