Downdetector

App · 25 actions

Follow Downdetector Enterprise service status, incidents and consumer reports, compare baselines, and inspect report locations, cities, providers and networks.

Actions

ActionWhat it does
Get cityCity details from Downdetector Enterprise.
Get companyDetails from Downdetector Enterprise.
Get company baseline24h Baseline from Downdetector Enterprise.
Get company recent reportsNumber of reports in last 15 minutes from Downdetector Enterprise.
Get company statusCurrent status from Downdetector Enterprise.
Get countryCountry details from Downdetector Enterprise.
Get current company baselineCurrent Baseline from Downdetector Enterprise.
Get current service heatmapHeatmap for reports from Downdetector Enterprise.
Get current service indicatorsCurrent indicators for slugs from Downdetector Enterprise.
Get indicatorIndicator details from Downdetector Enterprise.
Get providerDetails from Downdetector Enterprise.
Get service citiesCities for slugs from Downdetector Enterprise.
Get service countriesCountries for slugs from Downdetector Enterprise.
Get service indicatorsIndicators for slugs from Downdetector Enterprise.
Get service networksNetworks for slugs from Downdetector Enterprise.
Get service providersProviders for slugs from Downdetector Enterprise.
Get service reportsReports for slugs from Downdetector Enterprise.
Get siteDetails from Downdetector Enterprise.
List company eventsEvents from Downdetector Enterprise.
List company incidentsIncidents from Downdetector Enterprise.
List incidentsIncidents from Downdetector Enterprise.
List report locationsLocations for reports from Downdetector Enterprise.
List service companiesCompanies for slugs from Downdetector Enterprise.
List sitesList of available sites from Downdetector Enterprise.
Search companiesSearch companies from Downdetector Enterprise.

Get city

City details from Downdetector Enterprise.

Inputs

Geo idgeo_idnumberRequired
Geo ID for Cities

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get company

Details from Downdetector Enterprise.

Inputs

Companycompany_idnumberRequired
Id for a company
Fieldsfieldslist
Which fields to return in the output. The lesser you return, the faster the output can be. Only request the fields that you actually need in your views. **Status** The `status` field is a cached field for ease of use. It is advised to call the status endpoint `/company/[id]/status` for the latest status of a company. **Logos** The `logos` field is a special field, as it will return a dictionary of logo fields. If you only need the logo filename, you can use `logo`. **Contact** The `contact` field is a special field, as it will return a dictionary of contact fields. **ASNs*** If ASNs are configured for the company the `asns` field will return a list of ASN numbers. **Indicators** There are multi-level indicators possible, these will be presented as a "path-like" string, eg: - /animals/platypus - /animals/bird - etc. It is advised to display these as grouped under their respective paths, eg: ``` - Animals - Platypus - Bird ```One or more of: id, name, slug, url, stats_24 (Stats 24), stats_60 (Stats 60), baseline, baseline_current (Baseline current), category_id (Category id), logo, and 19 more.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get company baseline

24h Baseline from Downdetector Enterprise.

Inputs

Companycompany_idnumberRequired
Id for a company

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get company recent reports

Number of reports in last 15 minutes from Downdetector Enterprise.

Inputs

Companycompany_idnumberRequired
Id for a company
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get company status

Current status from Downdetector Enterprise.

Inputs

Companycompany_idnumberRequired
Id for a company
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Thresholdthresholdnumber
Checks if status is above this threshold. If so, returns 'danger', if not, returns 'success'
Indicatorindicatortext
Checks what the current status is for this indicator, only works with indicator_pct
Indicator pctindicator_pctnumber
Checks if the given indicator is above this threshold. This is only true when the company breached the given threshold, or calculated baseline.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get country

Country details from Downdetector Enterprise.

Inputs

Country isocountry_isotextRequired
ISO 2 string

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get current company baseline

Current Baseline from Downdetector Enterprise.

Inputs

Companycompany_idnumberRequired
Id for a company

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get current service heatmap

Heatmap for reports from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Zoomzoomnumber
Zoom level for groupingFrom 1 to 6.
CountriescountrieslistRequired
Country ids to filter on
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get current service indicators

Current indicators for slugs from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Countriescountrieslist
Country ids to filter on
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get indicator

Indicator details from Downdetector Enterprise.

Inputs

Indicator idindicator_idnumberRequired
Indicator id

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get provider

Details from Downdetector Enterprise.

Inputs

Network provider idnetwork_provider_idnumberRequired
Id for a provider

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get service cities

Cities for slugs from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Location sourcelocation_sourcetext
Filter on specific location source typesOne of: ip, device.
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Asnasnlist
Filter reports on these network ids (ASN, RFC 1771)
Amountamountnumber
Top X of buckets to returnFrom 10 to 512.
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
Countriescountrieslist
Country ids to filter on
Citiescitieslist
[BETA] City ids to filter on
Providersproviderslist
[BETA] Provider ids to filter on
Indicatorsindicatorslist
[BETA] Indicator ids to filter on

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get service countries

Countries for slugs from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Asnasnlist
Filter reports on these network ids (ASN, RFC 1771)
Amountamountnumber
Top X of buckets to returnFrom 10 to 512.
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get service indicators

Indicators for slugs from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Location sourcelocation_sourcetext
Filter on specific location source typesOne of: ip, device.
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Asnasnlist
Filter reports on these network ids (ASN, RFC 1771)
Amountamountnumber
Top X of buckets to returnFrom 10 to 512.
Countriescountrieslist
Country ids to filter on
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
Citiescitieslist
[BETA] City ids to filter on
Providersproviderslist
[BETA] Provider ids to filter on
Indicatorsindicatorslist
[BETA] Indicator ids to filter on

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get service networks

Networks for slugs from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Amountamountnumber
Top X of buckets to returnFrom 10 to 512.
Countriescountrieslist
Country ids to filter on
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get service providers

Providers for slugs from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Location sourcelocation_sourcetext
Filter on specific location source typesOne of: ip, device.
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Asnasnlist
Filter reports on these network ids (ASN, RFC 1771)
Amountamountnumber
Top X of buckets to returnFrom 10 to 512.
Countriescountrieslist
Country ids to filter on
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
Citiescitieslist
[BETA] City ids to filter on
Providersproviderslist
[BETA] Provider ids to filter on
Indicatorsindicatorslist
[BETA] Indicator ids to filter on

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get service reports

Reports for slugs from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Location sourcelocation_sourcetext
Filter on specific location source typesOne of: ip, device.
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Asnasnlist
Filter reports on these network ids (ASN, RFC 1771)
Providersproviderslist
[BETA] Provider ids to filter on
Indicatorsindicatorslist
[BETA] Indicator ids to filter on
Citiescitieslist
[BETA] City ids to filter on
Intervalintervaltext
Interval for the time based buckets, examples: 15m (15 minutes), 1m, 5m, 10m, 1h, 24h, 1d, 2d, etc.
Offsetoffsettext
Sets the offset for the bucket calculation. eg, if interval is set to 15 minutes, default buckets will be at :00, :15, :30, :45 marks. With this you can set the offset. For example given an interval of 15 minutes, and an offset of 7 minutes: :07, :22, :37, :52
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
Countriescountrieslist
Country ids to filter on

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

Get site

Details from Downdetector Enterprise.

Inputs

Sitesite_idnumberRequired
Id for a site

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

List company events

Events from Downdetector Enterprise.

Inputs

Companycompany_idnumberRequired
Id for a company
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Page sizepage_sizenumber
Amount of results per page, between 10 and 100, defaults to 10From 10 to 100.
Pagepagetext
On each query, a `X-Page-Next` header will be returned with a token as value. If the header has an empty value or is not present in the response headers, no other pages are available. For paging, provide this token for following pages. When calling the next pages, be sure to also include any initial parameters. Don't change those parameters while you are paging a resultset (they are part of the way the pageset is calculated).

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": []
  }
}

List company incidents

Incidents from Downdetector Enterprise.

Inputs

Companycompany_idnumberRequired
Id for a company
Peak attributionpeak_attributionnumber
See the attribution endpoint for more information about attribution enumsOne of: 0, 1, 2, 3.
Peak user impactpeak_user_impactnumber
See the attribution endpoint for more information about user impact enumsOne of: 0, 1, 2, 3.
Only activeonly_activetrue/false
When true, only the active incident will be returned
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Pagepagenumber
Requested page numberAt least 1.
Page sizepage_sizenumber
Amount of results per page, between 10 and 100, defaults to 10From 10 to 100.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": []
  }
}

List incidents

Incidents from Downdetector Enterprise.

Inputs

Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Only activeonly_activetrue/false
When true, only the active incident will be returned
Peak attributionpeak_attributionnumber
See the attribution endpoint for more information about attribution enumsOne of: 0, 1, 2, 3.
Peak user impactpeak_user_impactnumber
See the attribution endpoint for more information about user impact enumsOne of: 0, 1, 2, 3.
Pagepagenumber
Requested page numberAt least 1.
Page sizepage_sizenumber
Amount of results per page, between 10 and 100, defaults to 10From 10 to 100.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": []
  }
}

List report locations

Locations for reports from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Pagepagetext
On each query, a `X-Page-Next` header will be returned with a token as value. If the header has an empty value or is not present in the response headers, no other pages are available. For paging, provide this token for following pages. When calling the next pages, be sure to also include any initial parameters. Don't change those parameters while you are paging a resultset (they are part of the way the pageset is calculated).
Page sizepage_sizenumber
Amount of results per pageFrom 10 to 1000.
Location sourcelocation_sourcetext
Filter on specific location source typesOne of: ip, device.
Startdatestartdatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with enddate. - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Enddateenddatedate and time
ISO8601, limits the results to start on this date, only works in conjunction with startdate. Enddate is inclusive. So selecting `2020-04-01T13:37:00+00:00` as enddate, will include all reports for that specific second as well. This could mean that the last bucket of a timeselection is always empty when it collides with a time bucket, eg, every 15 minutes. For example, given this period: `12:00:00 - 12:15:00`, will return 2 buckets: - 12:00:00 - 12:14:59 - 12:15:00 - 12:29:59 The contents of the buckets will be filtered on the given period, so the last bucket will only have the reports for the one second of the given period, which could give unexpected results. Instead, when using: `12:00:00 - 12:14:59`, only 1 bucket will be returned: - 12:00:00 - 12:14:59 - Be aware that the `+` in RFC3339 format needs to be urlencoded. - Be aware that the timezone is divided by a colon in ISO8601, eg: `2042-03-14T13:37:42+01:00`
Swswlist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Nenelist
Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
Asnasnlist
Filter reports on these network ids (ASN, RFC 1771)
Companiescompanieslist
Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
Countriescountrieslist
Country ids to filter on
Citiescitieslist
[BETA] City ids to filter on
Providersproviderslist
[BETA] Provider ids to filter on
Indicatorsindicatorslist
[BETA] Indicator ids to filter on
Max pagesmax_pagesnumber
Maximum pages to fetch immediately, 1 to 100; default 5. Check pagination.complete before treating the results as complete.From 1 to 100.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": []
  }
}

List service companies

Companies for slugs from Downdetector Enterprise.

Inputs

SlugsslugslistRequired
Slug to filter on
Fieldsfieldslist
Which fields to return in the output. The lesser you return, the faster the output can be. Only request the fields that you actually need in your views. **Status** The `status` field is a cached field for ease of use. It is advised to call the status endpoint `/company/[id]/status` for the latest status of a company. **Logos** The `logos` field is a special field, as it will return a dictionary of logo fields. If you only need the logo filename, you can use `logo`. **Contact** The `contact` field is a special field, as it will return a dictionary of contact fields. **ASNs*** If ASNs are configured for the company the `asns` field will return a list of ASN numbers. **Indicators** There are multi-level indicators possible, these will be presented as a "path-like" string, eg: - /animals/platypus - /animals/bird - etc. It is advised to display these as grouped under their respective paths, eg: ``` - Animals - Platypus - Bird ```One or more of: id, name, slug, url, stats_24 (Stats 24), stats_60 (Stats 60), baseline, baseline_current (Baseline current), category_id (Category id), logo, and 19 more.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": []
  }
}

List sites

List of available sites from Downdetector Enterprise.

Inputs

None.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": []
  }
}

Search companies

Search companies from Downdetector Enterprise.

Inputs

Fieldsfieldslist
Which fields to return in the output. The lesser you return, the faster the output can be. Only request the fields that you actually need in your views. Note: `/companies/search` restricts to a narrow allowlist (`id`, `name`, `slug`, `url`, `country_iso`, `country_id`, `category_id`) once DD-9725 is live. For real-time status, statistics, indicators, and other rich fields, use `/companies/{company_id}`.One or more of: id, name, slug, url, stats_24 (Stats 24), stats_60 (Stats 60), baseline, baseline_current (Baseline current), category_id (Category id), logo, and 18 more.
Namenametext
Company name to filter for, this will be a partial match, case insensitive.
Countrycountrytext
Country to filter on, iso 2
Category idcategory_idnumber
Category id to filter on
Slugslugtext
Slug to filter on, full match
Pagepagenumber
1-indexed page number for paginated results.At least 1.
Page sizepage_sizenumber
Number of results per page, between 10 and 100.From 10 to 100.

Outputs

responseobject
The complete service response, including resource data and pagination fields.
Example output
{
  "response": {
    "data": {
      "id": "qa-resource"
    }
  }
}

On this page