In-Depth Daily

A synchronous endpoint used to calculate weather and NatCat risk probabilities for events, considering each day independently and returning an expected view across all days.

Request

POST /v1/in-depth/daily

Headers

Header	Required	Description
`X-API-Key`	Yes	Your API key
`Content-Type`	Yes	`application/json`

Body

Field	Type	Required	Description
`perils`	`list[string]`	Yes	Perils to evaluate. See Perils Reference.
`events`	`list[Event]`	Yes	Events to evaluate.

Event object

Field	Type	Required	Default	Description
`index`	`integer`	No	Auto-assigned from 0	Unique identifier for the event.
`tag`	`string`	No	`null`	Label for the risk.
`location`	`string`	Conditional	—	Location name, e.g. `"Los Angeles USA"`. Required if `latitude`/`longitude` not provided.
`latitude`	`float`	Conditional	—	Latitude. Required with `longitude` if `location` not provided.
`longitude`	`float`	Conditional	—	Longitude. Required with `latitude` if `location` not provided.
`start_date`	`string`	No	Today (GMT, BST)	Start date in `YYYY-MM-DD` format.
`end_date`	`string`	No	Today (GMT, BST)	End date in `YYYY-MM-DD` format. Must be ≥ `start_date`.
`start_hour`	`integer`	No	`0`	Start hour of day (0–23).
`end_hour`	`integer`	No	`23`	End hour of day (0–23). Must be ≥ `start_hour`.

Note: When using hours the interval from start_hour:00 to end_hour:59 is evaluated.

Example request

{
  "perils": ["Rain", "MaxWindGust"],
  "events": [
    {
      "index": 0,
      "tag": "London concert",
      "location": "London UK",
      "start_date": "2025-07-01",
      "end_date": "2025-07-03",
      "start_hour": 8,
      "end_hour": 20
    },
    {
      "index": 1,
      "latitude": 40.7128,
      "longitude": -74.006,
      "start_date": "2025-08-15",
      "end_date": "2025-08-15"
    }
  ]
}

Response

Success (200)

Field	Type	Description
`results`	`list[Result]`	One entry per peril-event combination.
`failed_items`	`list[FailedItem]`	Events that failed processing. Empty on full success.
`metadata`	`Metadata`	Summary of request processing.

Result object

Field	Type	Description
`index`	`integer`	Event index.
`peril`	`string`	Peril name.
`latitude`	`float`	Resolved latitude.
`longitude`	`float`	Resolved longitude.
`threshold`	`list[float\\|string]`	All available threshold values for the peril.
`probability`	`list[float]`	Exceedance probability at each threshold.
`return_period`	`list[float]`	Exceedance probability at each threshold, expressed as a return period
`unit`	`string`	Unit of the thresholds.

Metadata object

Field	Type	Description
`total_requested`	`integer`	Number of events in the request.
`successful`	`integer`	Events processed successfully.
`failed`	`integer`	Number of failed items.
`partial_failure`	`boolean`	`true` if some events failed but others succeeded.

FailedItem object

Field	Type	Description
`index`	`integer`	Event index that failed.
`stage`	`string`	Processing stage where failure occurred (`geocoding`, `model_execution`).
`error`	`string`	Description of the error.

Example response

{
  "results": [
    {
      "index": 0,
      "peril": "Rain",
      "latitude": 51.5074,
      "longitude": -0.1278,
      "threshold": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25],
      "probability": [0.95, 0.82, 0.65, 0.48, 0.33, 0.22, 0.15, 0.10, 0.07, 0.05, 0.03, 0.01, 0.004, 0.001],
      "unit": "mm"
    }
  ],
  "failed_items": [],
  "metadata": {
    "total_requested": 2,
    "successful": 2,
    "failed": 0,
    "partial_failure": false
  }
}

Limits

Maximum 25 peril-event combinations per request (e.g. 5 perils x 5 events).
end_date must be on or after start_date.
end_hour must be >= start_hour.

Errors

Status	Description
401	Missing or invalid API key.
422	Validation error (invalid perils, dates, or exceeding limits).