{"openapi":"3.1.1","info":{"title":"Russian Plague Tracker Data API","version":"1.0.0","description":"Free read-only cleaned reporting. No authentication. GET and HEAD read published snapshots; OPTIONS supports CORS. Explicit JSON paths also work on a static export. Query parameters are not supported. Follow next links for reports. Reputable news is accepted as reported; this is not official surveillance data. Cite citationUrl, metric asOf dates and original sources. Preserve nulls and source qualifications. Full terms and definitions are on /data/.","contact":{"name":"tensorfish","url":"https://x.com/tensorfish","email":"tensorfish@proton.em"}},"servers":[{"url":"https://russiaplague.live"}],"security":[],"externalDocs":{"url":"https://russiaplague.live/data/"},"paths":{"/api/v1/index.json":{"get":{"operationId":"getApiDirectory","summary":"API links and field definitions","parameters":[],"responses":{"200":{"description":"Current published data. null is unknown; no value is inferred from an observation admission.","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","revision","updatedAt","url","datasetUrl","citationUrl","data"],"properties":{"apiVersion":{"const":"1"},"revision":{"type":"string","description":"SHA-256 identifier of the published dashboard snapshot, including derived status."},"updatedAt":{"type":["string","null"],"description":"Publication timestamp or date; not the event date."},"url":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"citationUrl":{"type":"string","format":"uri"},"data":{"type":"object"}}}}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Send as If-None-Match to check for changes."}}},"304":{"description":"Representation unchanged."},"400":{"description":"Query parameters are unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown endpoint, country or page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/summary.json":{"get":{"operationId":"getWorldSummary","summary":"Worldwide counts and source-linked country contributions","parameters":[],"responses":{"200":{"description":"Current published data. null is unknown; no value is inferred from an observation admission.","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","revision","updatedAt","url","datasetUrl","citationUrl","data"],"properties":{"apiVersion":{"const":"1"},"revision":{"type":"string","description":"SHA-256 identifier of the published dashboard snapshot, including derived status."},"updatedAt":{"type":["string","null"],"description":"Publication timestamp or date; not the event date."},"url":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"citationUrl":{"type":"string","format":"uri"},"data":{"$ref":"#/components/schemas/Summary"}}}}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Send as If-None-Match to check for changes."}}},"304":{"description":"Representation unchanged."},"400":{"description":"Query parameters are unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown endpoint, country or page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/countries.json":{"get":{"operationId":"listCountries","summary":"Reporting registry with latest figures and API links","parameters":[],"responses":{"200":{"description":"Current published data. null is unknown; no value is inferred from an observation admission.","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","revision","updatedAt","url","datasetUrl","citationUrl","data"],"properties":{"apiVersion":{"const":"1"},"revision":{"type":"string","description":"SHA-256 identifier of the published dashboard snapshot, including derived status."},"updatedAt":{"type":["string","null"],"description":"Publication timestamp or date; not the event date."},"url":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"citationUrl":{"type":"string","format":"uri"},"data":{"type":"array","items":{"$ref":"#/components/schemas/CountrySummary"}}}}}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Send as If-None-Match to check for changes."}}},"304":{"description":"Representation unchanged."},"400":{"description":"Query parameters are unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown endpoint, country or page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/countries/{code}.json":{"get":{"operationId":"getCountry","summary":"Country and state figures with per-metric sources","parameters":[{"name":"code","in":"path","required":true,"description":"Uppercase ISO alpha-2 reporting code, or XK; use countries.json to discover codes.","schema":{"type":"string","pattern":"^[A-Z]{2}$"},"example":"RU"}],"responses":{"200":{"description":"Current published data. null is unknown; no value is inferred from an observation admission.","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","revision","updatedAt","url","datasetUrl","citationUrl","data"],"properties":{"apiVersion":{"const":"1"},"revision":{"type":"string","description":"SHA-256 identifier of the published dashboard snapshot, including derived status."},"updatedAt":{"type":["string","null"],"description":"Publication timestamp or date; not the event date."},"url":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"citationUrl":{"type":"string","format":"uri"},"data":{"$ref":"#/components/schemas/Country"}}}}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Send as If-None-Match to check for changes."}}},"304":{"description":"Representation unchanged."},"400":{"description":"Query parameters are unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown endpoint, country or page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/countries/{code}/history.json":{"get":{"operationId":"getCountryHistory","summary":"Dated country figures with source attribution and qualifications","parameters":[{"name":"code","in":"path","required":true,"description":"Uppercase ISO alpha-2 reporting code, or XK; use countries.json to discover codes.","schema":{"type":"string","pattern":"^[A-Z]{2}$"},"example":"RU"}],"responses":{"200":{"description":"Current published data. null is unknown; no value is inferred from an observation admission.","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","revision","updatedAt","url","datasetUrl","citationUrl","data"],"properties":{"apiVersion":{"const":"1"},"revision":{"type":"string","description":"SHA-256 identifier of the published dashboard snapshot, including derived status."},"updatedAt":{"type":["string","null"],"description":"Publication timestamp or date; not the event date."},"url":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"citationUrl":{"type":"string","format":"uri"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Snapshot"}}}}}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Send as If-None-Match to check for changes."}}},"304":{"description":"Representation unchanged."},"400":{"description":"Query parameters are unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown endpoint, country or page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/reports/{page}.json":{"get":{"operationId":"listReports","summary":"Reports ordered newest first; 50 per page","parameters":[{"name":"page","in":"path","required":true,"schema":{"type":"integer","minimum":1},"example":1}],"responses":{"200":{"description":"Current published data. null is unknown; no value is inferred from an observation admission.","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","revision","updatedAt","url","datasetUrl","citationUrl","data"],"properties":{"apiVersion":{"const":"1"},"revision":{"type":"string","description":"SHA-256 identifier of the published dashboard snapshot, including derived status."},"updatedAt":{"type":["string","null"],"description":"Publication timestamp or date; not the event date."},"url":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"citationUrl":{"type":"string","format":"uri"},"data":{"$ref":"#/components/schemas/ReportPage"}}}}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Send as If-None-Match to check for changes."}}},"304":{"description":"Representation unchanged."},"400":{"description":"Query parameters are unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown endpoint, country or page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/countries/{code}/reports/{page}.json":{"get":{"operationId":"listCountryReports","summary":"Country reports; 50 per page","parameters":[{"name":"code","in":"path","required":true,"description":"Uppercase ISO alpha-2 reporting code, or XK; use countries.json to discover codes.","schema":{"type":"string","pattern":"^[A-Z]{2}$"},"example":"RU"},{"name":"page","in":"path","required":true,"schema":{"type":"integer","minimum":1},"example":1}],"responses":{"200":{"description":"Current published data. null is unknown; no value is inferred from an observation admission.","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","revision","updatedAt","url","datasetUrl","citationUrl","data"],"properties":{"apiVersion":{"const":"1"},"revision":{"type":"string","description":"SHA-256 identifier of the published dashboard snapshot, including derived status."},"updatedAt":{"type":["string","null"],"description":"Publication timestamp or date; not the event date."},"url":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"citationUrl":{"type":"string","format":"uri"},"data":{"$ref":"#/components/schemas/ReportPage"}}}}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Send as If-None-Match to check for changes."}}},"304":{"description":"Representation unchanged."},"400":{"description":"Query parameters are unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown endpoint, country or page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/dataset.json":{"get":{"operationId":"downloadDataset","summary":"Complete cleaned reporting dataset","parameters":[],"responses":{"200":{"description":"Current published data. null is unknown; no value is inferred from an observation admission.","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","revision","updatedAt","url","datasetUrl","citationUrl","data"],"properties":{"apiVersion":{"const":"1"},"revision":{"type":"string","description":"SHA-256 identifier of the published dashboard snapshot, including derived status."},"updatedAt":{"type":["string","null"],"description":"Publication timestamp or date; not the event date."},"url":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"citationUrl":{"type":"string","format":"uri"},"data":{"type":"object","required":["definitions","summary","countries","histories","reports"],"properties":{"definitions":{"type":"object","additionalProperties":{"type":"string"}},"summary":{"$ref":"#/components/schemas/Summary"},"countries":{"type":"array","items":{"$ref":"#/components/schemas/Country"}},"histories":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/Snapshot"}}},"reports":{"type":"array","items":{"$ref":"#/components/schemas/Report"}}}}}}}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Send as If-None-Match to check for changes."}}},"304":{"description":"Representation unchanged."},"400":{"description":"Query parameters are unsupported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown endpoint, country or page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Counts":{"type":"object","required":["infected","dead","recovered"],"additionalProperties":false,"properties":{"infected":{"type":["integer","null"],"minimum":0},"dead":{"type":["integer","null"],"minimum":0},"recovered":{"type":["integer","null"],"minimum":0}}},"Source":{"type":"object","required":["id","title","publisher","url","publishedAt","retrievedAt","type"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"publisher":{"type":"string"},"url":{"type":"string","format":"uri"},"publishedAt":{"type":"string","format":"date"},"retrievedAt":{"type":"string","format":"date"},"type":{"enum":["news","official","research"]}}},"Metrics":{"type":"object","required":["infected","dead","recovered"],"properties":{"infected":{"$ref":"#/components/schemas/Metric"},"dead":{"$ref":"#/components/schemas/Metric"},"recovered":{"$ref":"#/components/schemas/Metric"}}},"Country":{"type":"object","required":["code","name","hasReports","counts","metrics","notes","areas","observations","quarantines"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"hasReports":{"type":"boolean"},"asOf":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"coverage":{"enum":["national","partial",null]},"counts":{"$ref":"#/components/schemas/Counts"},"metrics":{"$ref":"#/components/schemas/Metrics"},"notes":{"type":"string","description":"Latest record qualifications and corrections; preserve these when quoting figures."},"areas":{"type":"array","items":{"type":"object","required":["code","name","level","parentCode","counts","metrics"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"level":{"enum":["state","district"]},"parentCode":{"type":"string"},"asOf":{"type":"string","format":"date"},"counts":{"$ref":"#/components/schemas/Counts"},"metrics":{"$ref":"#/components/schemas/Metrics"}}}},"observations":{"type":"array","items":{"type":"object","required":["areaName","regionCode","asOf","hospitalizedForObservation","sources"],"properties":{"areaName":{"type":"string"},"regionCode":{"type":"string"},"asOf":{"type":"string","format":"date"},"hospitalizedForObservation":{"type":"integer","minimum":0},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}}},"quarantines":{"type":"array","items":{"type":"object","required":["id","areaName","scope","status","currentStatus","asOf","sources"],"properties":{"id":{"type":"string"},"areaName":{"type":"string"},"scope":{"enum":["country","region","district","facility"]},"status":{"enum":["active","lifted","unknown"]},"currentStatus":{"enum":["active","lifted","unknown"]},"stale":{"type":"boolean"},"asOf":{"type":"string","format":"date"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}}},"historyUrl":{"type":"string","format":"uri"},"reportsUrl":{"type":"string","format":"uri"}}},"Metric":{"type":"object","required":["value","asOf","basis","partial","contributingAreas","sources"],"properties":{"value":{"type":["integer","null"],"minimum":0},"asOf":{"type":["string","null"]},"basis":{"enum":["reported","states","districts",null]},"partial":{"type":"boolean"},"contributingAreas":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}},"CountrySummary":{"type":"object","required":["code","name","hasReports","counts","url","apiUrl"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"hasReports":{"type":"boolean"},"counts":{"$ref":"#/components/schemas/Counts"},"asOf":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"apiUrl":{"type":"string","format":"uri"}}},"Summary":{"type":"object","required":["asOf","counts","coverage","history","contributors"],"properties":{"asOf":{"type":["string","null"]},"counts":{"$ref":"#/components/schemas/Counts"},"coverage":{"type":"object","additionalProperties":{"type":"object","properties":{"value":{"type":["integer","null"]},"reporting":{"type":"integer"},"total":{"type":"integer"}}}},"history":{"type":"array","items":{"type":"object","required":["date","counts"],"properties":{"date":{"type":"string","format":"date"},"counts":{"$ref":"#/components/schemas/Counts"}}}},"contributors":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/CountrySummary"},{"type":"object","required":["metrics","notes"],"properties":{"metrics":{"$ref":"#/components/schemas/Metrics"},"notes":{"type":"string"}}}]}}}},"Snapshot":{"type":"object","required":["date","counts","metrics","notes"],"properties":{"date":{"type":"string","format":"date"},"counts":{"$ref":"#/components/schemas/Counts"},"metrics":{"$ref":"#/components/schemas/Metrics"},"notes":{"type":"string"}}},"Report":{"type":"object","required":["id","country","countryName","title","summary","status","publishedAt","source","citationUrl"],"properties":{"id":{"type":"string"},"country":{"type":"string"},"countryName":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"status":{"enum":["confirmed","unconfirmed","context"]},"publishedAt":{"type":"string","format":"date"},"source":{"$ref":"#/components/schemas/Source"},"citationUrl":{"type":"string","format":"uri"}}},"ReportPage":{"type":"object","required":["page","pageSize","total","pages","previous","next","items"],"properties":{"page":{"type":"integer","minimum":1},"pageSize":{"const":50},"total":{"type":"integer","minimum":0},"pages":{"type":"integer","minimum":1},"previous":{"type":["string","null"]},"next":{"type":["string","null"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Report"}}}},"Error":{"type":"object","required":["apiVersion","error"],"properties":{"apiVersion":{"const":"1"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}