Public
Documentation Settings
No Environment
Double Column
cURL - cURL
Covid API
Introduction
GET
List of region names.
GET
List of provinces by iso code.
GET
List of reports.
GET
Total data by date.

Covid API

Based on public data provided by Johns Hopkins CSSE. Github Link. Please read the Terms of Use in the Readme file of the repository by above link before using this API.

GETList of region names.

https://covid-api.com/api/regions
Example Request
HTTP 200 OK
curl
curl --location '/api/regions'
200 OK
Example Response
json
{
  "iso": "CHN",
  "name": "China"
}
Content-Type

application/json

GETList of provinces by iso code.

https://covid-api.com/api/provinces/:iso
PATH VARIABLES
iso

schema type not provided

(Required) The ISO code

Example Request
HTTP 422 Unprocessable Entity
curl
curl --location '/api/provinces/:iso'
422 Unprocessable Entity (WebDAV) (RFC 4918)
Example Response
json
{
  "title": "HTTP Unprocessable Entity",
  "code": 0,
  "message": "The given data was invalid.",
  "fields": {
    "some_field": [
      "Error description array for Some Field."
    ]
  }
}
Content-Type

application/json

GETList of reports.

https://covid-api.com/api/reports?date=&q=&iso=&region_name=&region_province=
PARAMS
date

The date of report in the format Y-m-d | default current date

q

The query string for search by country/region and province

iso

Filter by country ISO code

region_name

Filter by country/region name

region_province

Filter by province name

Example Request
HTTP 200 OK
curl
curl --location 'https://covid-api.com/api/reports?date=2020-03-14&q=China%20Beijing&iso=CHN&region_name=China&region_province=Beijing'
200 OK
Example Response
json
{
  "data": [
    {
      "date": "2020-03-14",
      "confirmed": 437,
      "deaths": 8,
      "recovered": 349,
      "confirmed_diff": 1,
      "deaths_diff": 0,
      "recovered_diff": 7,
      "last_update": "2020-03-14 02:13:47",
      "active": 80,
      "active_diff": -6,
      "fatality_rate": 0.0183,
      "region": {
        "iso": "CHN",
        "name": "China",
        "province": "Beijing",
        "lat": "40.1824",
        "long": "116.4142",
        "cities": []
      }
    }
  ]
}
Server

nginx/1.14.0 (Ubuntu)

Content-Type

application/json

Transfer-Encoding

chunked

Connection

keep-alive

Cache-Control

no-cache, private

Date

Thu, 02 Apr 2020 17:21:54 GMT

X-RateLimit-Limit

60

X-RateLimit-Remaining

58

GETTotal data by date.

https://covid-api.com/api/reports/total?date=

The date of report in the format Y-m-d

PARAMS
date
Example Request
https://covid-api.com/api/reports/total?date=2020-04-15
curl
curl --location 'https://covid-api.com/api/reports/total?date=2020-04-15'
200 OK
Example Response
json
{
  "data": {
    "date": "2020-04-15",
    "last_update": "2020-04-15 23:04:26",
    "confirmed": 2056055,
    "confirmed_diff": 82340,
    "deaths": 134178,
    "deaths_diff": 8268,
    "recovered": 511019,
    "recovered_diff": 36758,
    "active": 1410858,
    "active_diff": 37314,
    "fatality_rate": 0.0653
  }
}
Server

nginx/1.14.0 (Ubuntu)

Content-Type

application/json

Transfer-Encoding

chunked

Connection

keep-alive

Cache-Control

no-cache, private

Date

Thu, 16 Apr 2020 10:17:48 GMT

X-RateLimit-Limit

2000

X-RateLimit-Remaining

1998