/diseases/case-series/filter

GET

GET

/diseases/case-series/filter

curl -G https://api.gideononline.com/diseases/case-series/filter \
     -H "Authorization: <apiKey>" \
     -d disease=10040 \
     -d country=G292

200Diseases_/diseases/case-series/filter_example

{
  "data": [
    {
      "id": "c_369938",
      "refs": "p 41728304",
      "cases": 134,
      "hash_id": "e0332889-2c0a-4d05-ac9b-f5d03b048699",
      "disease_id": 10040,
      "setting_id": 1652,
      "region_name": "Multiple locations",
      "country_code": "G292",
      "country_name": "United States",
      "disease_name": "HIV/AIDS",
      "parameter_id": 1150,
      "setting_name": "hospitals",
      "population_id": 1904,
      "parameter_name": "Coinfection - viral",
      "population_name": "patients - HIV / AIDS",
      "last_update_date": "2026-02-25 09:18:42",
      "publication_year": 2026
    }
  ],
  "timestamp": 1772011122,
  "record_count": 91
}

Returns case series rows matching optional filters. Results are ordered by the greater of start year and publication year (newest first).

Successful responses include record_count and timestamp (Unix epoch seconds from the most recent row update in the filtered set).

If the filter matches more than the server cap (default 500, case_series_max_records_without_filters), the API returns HTTP 200 with { "data": { "record_count", "max_records" } } instead of listing rows—tighten filters and call again.

Query parameters (all optional; camelCase)

Name	Description
`disease`	Numeric GIDEON disease identifier.
`country`	GIDEON country code for the reporting country.
`startYear` / `endYear`	Overlap window: with both set, a series must overlap that calendar range; with only `startYear`, the series’ effective end year must be ≥ `startYear`; with only `endYear`, its start year must be ≤ `endYear`. If no explicit end year exists for a series, its start year is used as the end for overlap checks.
`publicationYear`	Exact match on publication year.
`setting`	Setting id.
`population`	Population group id.
`parameter`	Case parameter id.
`region`	Region id for subdivision filtering.

Success with rows

{ "data": [ ... ], "record_count": <n>, "timestamp": <unix_epoch_seconds> } — normalized lowercase keys (e.g. id with c_ prefix, start_year, refs, region_name). timestamp is a Unix epoch integer (seconds), not an ISO-8601 string. The Postman example shows one data row for brevity; record_count is still the full filtered total.

Too many matches

{ "data": { "record_count", "max_records" } } with 200.

Errors

500 — Invalid request (generic error body).

Authentication

Authorizationstring

API Key authentication via header

Query parameters

diseaseintegerOptional

Numeric GIDEON disease identifier.

countrystringOptional

GIDEON country code.

Response

datalist of objects

timestampinteger

record_countinteger