{"openapi":"3.1.0","info":{"title":"EXE public-record index API","version":"1.0.0","description":"Read-only access to every record, official list entry and crime figure on exeindex.com. Every record carries its public source URL. Map coordinates are approximate unless precision is facility.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://exeindex.com"}],"paths":{"/api/v1/records":{"get":{"summary":"List records","parameters":[{"name":"types","in":"query","required":false,"description":"Comma-separated record types: executions, terrorism, gangs, insurgents, military","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Exact country name","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Status value","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Text search in name, country, region, list, actor, and source (max 100 chars)","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"First year (inclusive)","schema":{"type":"integer"}},{"name":"to","in":"query","required":false,"description":"Last year (inclusive)","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Page size, 1-1000 (default 100)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Offset (default 0)","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordPage"}}}},"400":{"description":"Bad query. limit, offset, page, from, to, and year must be whole numbers in range. Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset."},"429":{"description":"Rate limited. Retry-After and X-RateLimit-Reset are set."}}}},"/api/v1/records/{id}":{"get":{"summary":"One record","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordOne"}}}},"404":{"description":"Not found"}}}},"/api/v1/crime":{"get":{"summary":"Crime figures (long format)","parameters":[{"name":"scope","in":"query","required":false,"description":"country | state | city","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Crime type key","schema":{"type":"string"}},{"name":"place","in":"query","required":false,"description":"Place id","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Year","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Page size, 1-1000 (default 100)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Offset (default 0)","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrimePage"}}}}}}},"/api/v1/sources":{"get":{"summary":"Datasets and source URLs behind the records","responses":{"200":{"description":"OK"}}}},"/api/v1/stats":{"get":{"summary":"Counts per type","responses":{"200":{"description":"OK"}}}},"/api/v1/ledger":{"get":{"summary":"Content hashes, pending Merkle root, and anchor status for military-action records","responses":{"200":{"description":"OK"}}}},"/api/v1/export":{"get":{"summary":"Download an export","parameters":[{"name":"format","in":"query","required":false,"description":"xlsx | csv | json | geojson | sqlite | sql | postgres. sql is an alias of sqlite.","schema":{"type":"string"}},{"name":"types","in":"query","required":false,"description":"Comma-separated record types: executions, terrorism, gangs, insurgents, military","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Exact country name","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Status value","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Text search in name, country, region, list, actor, and source (max 100 chars)","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"First year (inclusive)","schema":{"type":"integer"}},{"name":"to","in":"query","required":false,"description":"Last year (inclusive)","schema":{"type":"integer"}},{"name":"crime","in":"query","required":false,"description":"1 to include crime figures","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"Crime scope when crime=1","schema":{"type":"string"}}],"responses":{"200":{"description":"File download (Content-Disposition: attachment)"},"400":{"description":"Unknown format or bad query"}}}}},"components":{"schemas":{"Record":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Stable record id (also the URL slug)"},"type":{"type":["string","null"],"description":"executions | terrorism | gangs | insurgents | military"},"name":{"type":["string","null"],"description":"Name as given by the source"},"status":{"type":["string","null"],"description":"Status in the source (executed, scheduled, designated, listed, ...)"},"date":{"type":["string","null"],"description":"Main date, ISO 8601 (execution, incident, designation or listing date)"},"country":{"type":["string","null"],"description":"Country named by the source"},"region":{"type":["string","null"],"description":"State, province or region named by the source"},"county":{"type":["string","null"],"description":"US county of the case (DPIC)"},"jurisdiction":{"type":["string","null"],"description":"Jurisdiction (executions)"},"method":{"type":["string","null"],"description":"Method category as recorded by DPIC (executions)"},"age":{"type":["integer","null"],"description":"Age at execution (DPIC)"},"list":{"type":["string","null"],"description":"Official list (FTO, UK proscribed, UN SC, OFAC SDN)"},"list_ref":{"type":["string","null"],"description":"Reference on the list (UN reference, OFAC id)"},"programs":{"type":["string","null"],"description":"Sanctions programs, semicolon-separated (OFAC)"},"kind":{"type":["string","null"],"description":"Entry kind (organization, incident, ofac-entity, un-entity, ...)"},"designated_date":{"type":["string","null"],"description":"Designation date (ISO 8601)"},"removed_date":{"type":["string","null"],"description":"Delisting date (ISO 8601)"},"lat":{"type":["number","null"],"description":"Map dot latitude (approximate unless precision is facility)"},"lng":{"type":["number","null"],"description":"Map dot longitude"},"precision":{"type":["string","null"],"description":"facility | city | region | country"},"location":{"type":["string","null"],"description":"Place the map dot stands for"},"summary":{"type":["string","null"],"description":"One-paragraph summary written from the source"},"source_title":{"type":["string","null"],"description":"Primary source title"},"source_url":{"type":["string","null"],"description":"Primary source URL"},"source_publisher":{"type":["string","null"],"description":"Primary source publisher"},"record_url":{"type":["string","null"],"description":"Page for this record on exeindex.com"},"actor":{"type":["string","null"],"description":"Actor named by the source (military actions)"},"retrieved":{"type":["string","null"],"description":"Date the source page was retrieved (YYYY-MM-DD)"},"content_hash":{"type":["string","null"],"description":"SHA-256 of the canonical JSON record (includes source URL and retrieval date)"}}},"CrimeRow":{"type":"object","properties":{"place_id":{"type":["string","null"],"description":"Place id (country-xxx, state-xx, city-xx-name)"},"place":{"type":["string","null"],"description":"Place name"},"scope":{"type":["string","null"],"description":"country | state | city"},"iso3":{"type":["string","null"],"description":"ISO 3166-1 alpha-3 (countries)"},"state":{"type":["string","null"],"description":"US state code (states, cities)"},"crime_type":{"type":["string","null"],"description":"Crime type key"},"crime_label":{"type":["string","null"],"description":"Crime type label"},"year":{"type":["integer","null"],"description":"Year"},"count":{"type":["integer","null"],"description":"Offenses / victims as published"},"rate":{"type":["number","null"],"description":"Per 100,000 people"},"rate_derived":{"type":["integer","null"],"description":"1 when the rate is derived (documented in Notes)"},"population":{"type":["integer","null"],"description":"Population used for the rate (FBI)"},"source_title":{"type":["string","null"],"description":"Source title"},"source_url":{"type":["string","null"],"description":"Source URL"}}},"RecordPage":{"type":"object","properties":{"meta":{"type":"object"},"records":{"type":"array","items":{"$ref":"#/components/schemas/Record"}}}},"RecordOne":{"type":"object","properties":{"record":{"$ref":"#/components/schemas/Record"}}},"CrimePage":{"type":"object","properties":{"meta":{"type":"object"},"rows":{"type":"array","items":{"$ref":"#/components/schemas/CrimeRow"}}}}}}}