Query Hail History at Multiple Points (GeoJSON)
POST a batch of lat/lon points and receive hail history for each, returned as a GeoJSON FeatureCollection.
POST a batch of lat/lon points and receive hail history for each, returned as a GeoJSON FeatureCollection.
Designed for bulk property screening, e.g. a roofing company uploading 50–200 job addresses to check for hail damage eligibility. All points are processed in parallel.
Request Body (JSON)
Two accepted formats:
Format A, points array:
{
"start": "2023-05-15T00:00:00",
"end": "2023-05-15T23:59:59",
"size": 1.0,
"points": [
{"lat": 35.4676, "lon": -97.5164, "id": "job-001"},
{"lat": 35.5100, "lon": -97.4800, "id": "job-002"}
]
}Format B, GeoJSON FeatureCollection of Points (with start, end, size as query params):
{
"type": "FeatureCollection",
"features": [
{"type": "Feature", "geometry": {"type": "Point", "coordinates": [-97.5164, 35.4676]},
"properties": {"id": "job-001"}}
]
}Limits
- Maximum 500 points per request
Response, GeoJSON FeatureCollection
One Feature per input point (order preserved), each with:
max_hail_size_in: peak corrected hail sizemax_hail_index: peak 0–5 hail impact indexbest_confidence: confidence label of the peak event,nullifevent_countis 0event_count: number of distinct stormsevents[]: full event list (same schema as single-point endpoint)
Token-based authentication with required prefix "Token"
In: header
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/lookback/hail/multi/" \ -H "Content-Type: application/json" \ -d '{ "start": "string", "end": "string" }'{ "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Point", "coordinates": [ -97.5164, 35.4676 ] }, "properties": { "id": "job-001", "query_start": "2023-05-15T00:00:00+00:00", "query_end": "2023-05-15T23:59:59+00:00", "max_hail_size_in": 1.75, "max_hail_index": 4.1, "best_confidence": "high", "event_count": 1, "events": [ { "timestamp": "2023-05-15T18:00:00+00:00", "start_time": "2023-05-15T18:00:00+00:00", "end_time": "2023-05-15T18:48:00+00:00", "duration_min": 48, "estimated_hail_size_in": 1.75, "raw_mrms_hail_size_in": 1.65, "coverage": 0.22, "coverage_label": "medium", "confidence": 4, "confidence_label": "high", "hail_index": 4.1, "nearest_spc_report_id": "spc-hail-20230515-1810-3546n09751w", "detection_source": "mrms" } ] } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [ -97.48, 35.51 ] }, "properties": { "id": "job-002", "query_start": "2023-05-15T00:00:00+00:00", "query_end": "2023-05-15T23:59:59+00:00", "max_hail_size_in": 0, "max_hail_index": 0, "best_confidence": null, "event_count": 0, "events": [] } } ]}