Skip to content
GET/api/hazard/suicide-attacks/1 credit

Suicide attacks

A stored dataset of suicide bombing incidents with location and casualty figures. It is a historical event record rather than an astrological calculation; it is here so that mundane analysis can draw event data and chart data from the same API. Records are located by city and province rather than by country, and the loaded data is centred on Pakistan (Balochistan, Khyber Pakhtunkhwa, Punjab, Sindh). Filter with `city` and `province`, both case-insensitive substring matches, with `start_date` and `end_date` on the incident date, and with `min_killed`, `max_killed`, `min_injured` and `no_of_suicide_blasts`. `sort` accepts 'newest' (the default), 'oldest', 'killed_desc', 'killed_asc', 'injured_desc' and 'injured_asc'. Paging uses `page` and `itemsPerPage`, fifty per page by default and up to five hundred. The response is a paged envelope of `count`, `next`, `previous` and `results`. Each result gives an id, the date, a local time string, city, province, latitude and longitude, a free-text `location` naming the exact spot, `killed_min` and `killed_max` (reported casualty figures often being a range), `injured_min` and the number of blasts in the incident.

https://yogataraapi.prahlad.app/api/hazard/suicide-attacks/
Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…

Query parameters (11)

Passed in the URL. All optional unless marked, and they combine — filter, then page, then sort.

ParameterTypeExampleWhat it does
citystringFilter by city name (case-insensitive contains)
end_datestringFilter by end date (YYYY-MM-DD)

FORMAT constraint: 'YYYY-MM-DD'. Compared with `date__lte`.

itemsPerPageintegerNumber of items per page
max_killedintegerFilter by maximum killed (max count)
min_injuredintegerFilter by minimum injured (min count)
min_killedintegerFilter by minimum killed (max count)
no_of_suicide_blastsintegerFilter by exact number of suicide blasts
pageintegerPage number
provincestringFilter by province name (case-insensitive contains)
sortstringSort order: 'newest' (default), 'oldest', 'killed_desc'/'killed_asc' (by killed count), or 'injured_desc'/'injured_asc' (by injured count)

Case-insensitive and stripped. Default 'newest'. There is NO name_asc/name_desc here because no name_field is passed. 'killed_*' sorts on killed_max, 'injured_*' on injured_min. Unrecognised values silently fall back to 'newest'.

one of: newest, oldest, killed_desc, killed_asc, injured_desc, injured_asc
start_datestringFilter by start date (YYYY-MM-DD)

FORMAT constraint: 'YYYY-MM-DD'. Compared with `date__gte`.

Example request

curl "https://yogataraapi.prahlad.app/api/hazard/suicide-attacks/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Response

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"count\": 284, \"next\": \"http://127.0.0.1:8000/api/hazard/suicide-attacks/?page=2\", \"previous\": null, \"results\": [{\"id\": 284, \"date\": \"2017-11-25\", \"time\": \"7:00 AM\", \"city\": \"Quetta\", \"latitude\": 30.139626, \"longitude\": 66.981476, \"province\": \"Balochistan\", \"location\": \"Sariab Road, near Bus terminal\", \"killed_min\": 4, \"killed_max\": 4, \"injured_min\": 16, \"no_of_suicide_blasts\": 1}, {\"id\": 283, \"date\": \"2017-11-24\", \"time\": \"7:00 AM\", \"city\": \"Peshawar\", \"latitude\": 33.970623, \"longitude\": 71.43862, \"province\": \"KPK\", \"location\": \"Near Zarghuni Masjid, Phase-2 Hayatabad\", \"killed_min\": 1, \"killed_max\": 3, \"injured_min\": 6, \"no_of_suicide_blasts\": 1}, {\"id\": 282, \"date\": \"2017-11-09\", \"time\": \"7:00 AM\", \"city\": \"Quetta\", \"latitude\": 30.221057, \"longitude\": 67.002524, \"province\": \"Balochistan\", \"location\": \"Quetta's Chaman Housing Scheme on airport road\", \"killed_min\": 2, \"killed_max\": 2, \"injured_min\": 8, \"no_of_suicide_blasts\": 1}, {\"id\": 281, \"date\": \"2017-08-12\", \"time\": \"5:00 PM\", \"city\": \"Quetta\", \"latitude\": 30.203658, \"longitude\": 67.004469, \"province\": \"Balochistan\", \"location\": \"Pishin bus stop\", \"killed_min\": 15, \"killed_max\": 15, \"injured_min\": 40, \"no_of_suicide_blasts\": 1}, {\"id\": 280, \"date\": \"2017-07-24\", \"time\": \"3:55 PM\", \"city\": \"Lahore\", \"latitude\": 31.500875, \"longitude\": 74.33312, \"province\": \"Punjab\", \"location\": \"near Arfa Karim IT Tower Ferozepur Road\", \"killed_min\": 26, \"killed_max\": 27, \"injured_min\": 56, \"no_of_suicide_blasts\": 1}, {\"id\": 279, \"date\": \"2017-07-10\", \"time\": \"11:43 AM\", \"city\": \"Chaman\", \"latitude\": 30.90983, \"longitude\": 66.452402, \"province\": \"Balochistan\", \"location\": \"Boghra Road\", \"killed_min\": 1, \"killed_max\": 3, \"injured_min\": 1, \"no_of_suicide_blasts\": 1}, {\"id\": 278, \"date\": \"2017-06-23\", \"time\": \"1:30 PM\", \"city\": \"Quetta\", \"latitude\": 33.88423, \"longitude\": 70.10878, \"province\": \"Balochistan\", \"location\": \"Parachinar town in the restive tribal bel\", \"killed_min\": 30, \"killed_max\": 85, \"injured_min\": 100, \"no_of_suicide_blasts\": 3}, {\"id\": 277, \"date\": \"2017-05-12\", \"time\": \"2:30 PM\", \"city\": \"Quetta\", \"latitude\": 29.800833, \"longitude\": 66.848056, \"province\": \"Baluchistan\", \"location\": \"Town of Mastung\", \"killed_min\": 25, \"killed_max\": 28, \"injured_min\": 35, \"no_of_suicide_blasts\": 1}, {\"id\": 276, \"date\": \"2017-04-05\", \"time\": \"7:15 AM\", \"city\": \"Lahore\", \"latitude\": 31.463017, \"longitude\": 74.435675, \"province\": \"Punjab\", \"location\": \"Bedian Road\", \"killed_min\": 6, \"killed_max\": 7, \"injured_min\": 19, \"no_of_suicide_blasts\": null}, {\"id\": 275, \"date\": \"2017-02-21\", \"time\": \"9:00 AM\", \"city\": \"Tangi, Charsadda District\", \"latitude\": 34.3, \"longitude\": 71.653889, \"province\": \"KPK\", \"location\": \"Court\", \"killed_min\": 6, \"killed_max\": 7, \"injured_min\": 15, \"no_of_suicide_blasts\": 2}, {\"id\": 274, \"date\": \"2017-02-16\", \"time\": \"6:00 PM\", \"city\": \"Sehwan town\", \"latitude\": 26.419314, \"longitude\": 67.859373, \"province\": \"Sindh\", \"location\": \"Lal Shahbaz Qalandar shrine\", \"killed_min\": 70, \"killed_max\": 72, \"injured_min\": 150, \"no_of_suicide_blasts\": 1}, {\"id\": 272, \"date\": \"2017-02-15\", \"time\": \"3:30 PM\", \"city\": \"Hayatabad\", \"latitude\": 33.986111, \"longitude\": 71.456944, \"province\": \"KPK\", \"location\": \"Hayatabad Medical Complex\", \"killed_min\": 1, \"killed_max\": 1, \"injured_min\": 4, \"no_of_suicide_blasts\": 1}, {\"id\": 273, \"date\": \"2017-02-15\", \"time\": \"9:00 AM\", \"city\": \"Mosal Kor, Mohmand Agency\", \"latitude\": 34.553808, \"longitude\": 71.434141, \"province\": \"FATA\", \"location\": \"Office of political agent\", \"killed_min\": 1, \"killed_max\": 1, \"injured_min\": 0, \"no_of_suicide_blasts\": 1}, {\"id\": 271, \"date\": \"2017-02-15\", \"time\": \"8:00 AM\", \"city\": \"Ghallanai, Mohmand Agency\", \"latitude\": 34.5, \"longitude\": 71.333333, \"province\": \"FATA\", \"location\": \"main gate of Mohmand Agency headquarters, Ghallanai\", \"killed_min\": 5, \"killed_max\": 8, \"injured_min\": 0, \"no_of_suicide_blasts\": 1}, {\"id\": 270, \"date\": \"2017-02-13\", \"time\": \"6:00 PM\", \"city\": \"Lahore\", \"latitude\": 31.555382, \"longitude\": 74.3"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.