Covid-19

Riskline provides two types of integrations for its Covid APIs.

  1. Push API - where Riskline pushes the data out to a third party server
  2. Pull API - where third parties fetch data from Riskllne

Both API include country-level, region-level and city-level information.

Push API

There is one request per country that contains the country information, as well as regions and cities data.

Report is sent via a POST request.

POST https://example.com/countries/ (example)

Every time the data changes a request is made to your server.

Format

There are two data formats available: plain json and jsonapi spec.

Sample JSON

https://gist.github.com/riskline/c5097ffb1ef426b94431be450b770a5b

More details are available and ready for testing in our Developer Portal.

Pull API

The request needs an authorisation token received from Riskline.

Country data

Fetch data from only specific countries, by iso codes

GET https://api.riskline.com/covid/countries?country_codes=ro,us

You can override the defaults in the service configuration and select the version (v1 or v2) and content type (json or jsonapi).

GET https://api.riskline.com/covid/countries.json

GET https://api.riskline.com/covid/countries.jsonapi

GET https://api.riskline.com/covid/countries.json?version=v1

GET https://api.riskline.com/covid/countries.json?version=v2

Format

There are two data formats: plain json and jsonapi spec.

Sample JSON

https://gist.github.com/riskline/c5097ffb1ef426b94431be450b770a5b

More details are available and ready for testing in our Developer Portal.

Explanation of field values

{
"countries": [
{
"name": "string",
"code": "string",
"risk_level": "string",
"covid_risk_level": "string",
"infection": {
"rate": 0,
"level": "string",
"as_of_date": "string"
},
"hotspots": "string",
"domestic_infection_map": "string",
"summary": "string",
"policy": {
"current_status": "string",
"start_date": "string",
"end_date": "string",
"text": "string",
"last_update": "string"
},
"international_travel": {
"international_flights": {
"is_banned": "string",
"through_date": "string",
"text": "string",
"last_update": "string"
},
"entry_and_borders": {
"entry_ban": "string",
"through_date": "string",
"text": "string",
"entry_rules": "string",
"exemptions": "string",
"last_update": "string"
},
"testing": {
"need_test": "string",
"when": "string",
"requirement": "string",
"text": "string",
"rules": "string",
"last_update": "string"
},
"health_travel_documentations": {
"need_documentations": "string",
"text": "string",
"health_document": "string",
"travel_document": "string",
"last_update": "string"
},
"tracing_app": {
"need_app": "string",
"text": "string",
"website": "string",
"last_update": "string"
},
"quarantine_on_arrival": {
"who_needs": "string",
"days": 0,
"type": "string",
"text": "string",
"rules": "string",
"mandate_list": "string",
"last_update": "string"
},
"masks": {
"requirement": "string",
"text": "string",
"last_update": "string"
},
"exit_country": {
"requirement": "string",
"text": "string",
"exit_requirements": "string",
"last_update": "string"
},
"other_international_travel_restrictions": {
"text": "string",
"last_update": "string"
}
},
"domestic_situation": {
"areas_on_lockdown": {
"text": "string",
"last_update": "string"
},
"areas_under_curfew": {
"text": "string",
"last_update": "string"
},
"domestic_travel": {
"text": "string",
"last_update": "string"
},
"other_domestic_restrictions": {
"text": "string",
"last_update": "string"
}
},
"resources": {
"government_covid_site": "string",
"health_dept_covid_site": "string",
"covid_dashboard": "string"
},
"regions": [
{
"name": "string",
"code": "string",
"risk_level": "string",
"covid_risk_level": "string",
"infection": {
"rate": 0,
"level": "string",
"as_of_date": "string"
},
"policy": {
"current_status": "string",
"end_date": "string",
"text": "string",
"last_update": "string"
},
"entry_and_borders": {
"entry_ban": "string",
"through_date": "string",
"text": "string",
"entry_rules": "string",
"exemptions": "string",
"last_update": "string"
},
"testing": {
"need_test": "string",
"when": "string",
"requirement": "string",
"text": "string",
"rules": "string",
"last_update": "string"
},
"health_travel_documentations": {
"need_documentations": "string",
"text": "string",
"health_document": "string",
"travel_document": "string",
"last_update": "string"
},
"tracing_app": {
"need_app": "string",
"text": "string",
"website": "string",
"last_update": "string"
},
"domestic_quarantine_on_arrival": {
"who_needs": "string",
"days": 0,
"type": "string",
"text": "string",
"rules": "string",
"mandate_list": "string",
"last_update": "string"
},
"masks": {
"requirement": "string",
"text": "string",
"last_update": "string"
},
"areas_on_lockdown": {
"text": "string",
"last_update": "string"
},
"areas_under_curfew": {
"text": "string",
"last_update": "string"
},
"domestic_travel": {
"text": "string",
"last_update": "string"
},
"other_internal_restrictions": {
"text": "string",
"last_update": "string"
},
"resources": {
"government_covid_site": "string",
"health_dept_covid_site": "string"
}
}
],
"cities": [
{
"name": "string",
"code": "string",
"covid_risk_level": "string",
"summary": "string",
"lat": "string",
"lng": "string"
}
]
}
]
}

Possible values

{
"policy":{
"current_status": ['Lockdown', 'Stay at home', 'Curfew', 'Closing', 'Opening', 'Open', 'Partial Measures', 'Distancing', 'None'],
},
"international_flights": {
"is_banned": ['Yes', 'No', 'Partial']
},
"entry_and_borders":{
"is_banned": ['Yes', 'No', 'Partial']
},
"testing": {
"needed": ['Yes', 'No', 'Yes, conditional'],
"when": ['Before travel', 'Upon arrival', 'After arrival'],
"mandatory": ['Mandatory', 'Optional']
},
"health_travel_documentations": {
"need_documentations": ['Yes', 'No'],
},
"tracing_app": {
"need_app":: ['Yes', 'No', 'Recommended'],
},
"quarantine_on_arrival": {
"who_needs": ['All travellers', 'Some travellers', 'None']
"type": ['Self', 'Gov', 'Hybrid']
},
"masks": {
"requirement": ['Yes', 'No', 'Yes, conditional', 'Partial', 'Recommended'],
},
"exit_country": {
"exit_requirements": ['Yes', 'No', 'Yes, conditional']
},
"risk_level": [“Low”, “Moderate”, “Medium”, “High”, “Extreme”]
}
Did this answer your question?