Downdetector
App · 25 actions
Follow Downdetector Enterprise service status, incidents and consumer reports, compare baselines, and inspect report locations, cities, providers and networks.
Actions
| Action | What it does |
|---|---|
| Get city | City details from Downdetector Enterprise. |
| Get company | Details from Downdetector Enterprise. |
| Get company baseline | 24h Baseline from Downdetector Enterprise. |
| Get company recent reports | Number of reports in last 15 minutes from Downdetector Enterprise. |
| Get company status | Current status from Downdetector Enterprise. |
| Get country | Country details from Downdetector Enterprise. |
| Get current company baseline | Current Baseline from Downdetector Enterprise. |
| Get current service heatmap | Heatmap for reports from Downdetector Enterprise. |
| Get current service indicators | Current indicators for slugs from Downdetector Enterprise. |
| Get indicator | Indicator details from Downdetector Enterprise. |
| Get provider | Details from Downdetector Enterprise. |
| Get service cities | Cities for slugs from Downdetector Enterprise. |
| Get service countries | Countries for slugs from Downdetector Enterprise. |
| Get service indicators | Indicators for slugs from Downdetector Enterprise. |
| Get service networks | Networks for slugs from Downdetector Enterprise. |
| Get service providers | Providers for slugs from Downdetector Enterprise. |
| Get service reports | Reports for slugs from Downdetector Enterprise. |
| Get site | Details from Downdetector Enterprise. |
| List company events | Events from Downdetector Enterprise. |
| List company incidents | Incidents from Downdetector Enterprise. |
| List incidents | Incidents from Downdetector Enterprise. |
| List report locations | Locations for reports from Downdetector Enterprise. |
| List service companies | Companies for slugs from Downdetector Enterprise. |
| List sites | List of available sites from Downdetector Enterprise. |
| Search companies | Search companies from Downdetector Enterprise. |
Get city
City details from Downdetector Enterprise.
Inputs
- Geo id
geo_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
- Company
company_idnumberRequired - Id for a company
- Fields
fieldslist - 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
- Company
company_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
- Company
company_idnumberRequired - Id for a company
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Ne
nelist - 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
- Company
company_idnumberRequired - Id for a company
- Ne
nelist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Threshold
thresholdnumber - Checks if status is above this threshold. If so, returns 'danger', if not, returns 'success'
- Indicator
indicatortext - Checks what the current status is for this indicator, only works with indicator_pct
- Indicator pct
indicator_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 iso
country_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
- Company
company_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
- Slugs
slugslistRequired - Slug to filter on
- Zoom
zoomnumber - Zoom level for groupingFrom 1 to 6.
- Countries
countrieslistRequired - Country ids to filter on
- Companies
companieslist - 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
- Slugs
slugslistRequired - Slug to filter on
- Countries
countrieslist - Country ids to filter on
- Companies
companieslist - 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 id
indicator_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 id
network_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
- Slugs
slugslistRequired - Slug to filter on
- Location source
location_sourcetext - Filter on specific location source typesOne of:
ip,device. - Startdate
startdatedate 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`
- Enddate
enddatedate 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`
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Ne
nelist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Asn
asnlist - Filter reports on these network ids (ASN, RFC 1771)
- Amount
amountnumber - Top X of buckets to returnFrom 10 to 512.
- Companies
companieslist - Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
- Countries
countrieslist - Country ids to filter on
- Cities
citieslist - [BETA] City ids to filter on
- Providers
providerslist - [BETA] Provider ids to filter on
- Indicators
indicatorslist - [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
- Slugs
slugslistRequired - Slug to filter on
- Startdate
startdatedate 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`
- Enddate
enddatedate 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`
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Ne
nelist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Asn
asnlist - Filter reports on these network ids (ASN, RFC 1771)
- Amount
amountnumber - Top X of buckets to returnFrom 10 to 512.
- Companies
companieslist - 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
- Slugs
slugslistRequired - Slug to filter on
- Location source
location_sourcetext - Filter on specific location source typesOne of:
ip,device. - Startdate
startdatedate 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`
- Enddate
enddatedate 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`
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Ne
nelist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Asn
asnlist - Filter reports on these network ids (ASN, RFC 1771)
- Amount
amountnumber - Top X of buckets to returnFrom 10 to 512.
- Countries
countrieslist - Country ids to filter on
- Companies
companieslist - Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
- Cities
citieslist - [BETA] City ids to filter on
- Providers
providerslist - [BETA] Provider ids to filter on
- Indicators
indicatorslist - [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
- Slugs
slugslistRequired - Slug to filter on
- Startdate
startdatedate 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`
- Enddate
enddatedate 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`
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Ne
nelist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Amount
amountnumber - Top X of buckets to returnFrom 10 to 512.
- Countries
countrieslist - Country ids to filter on
- Companies
companieslist - 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
- Slugs
slugslistRequired - Slug to filter on
- Location source
location_sourcetext - Filter on specific location source typesOne of:
ip,device. - Startdate
startdatedate 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`
- Enddate
enddatedate 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`
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Ne
nelist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Asn
asnlist - Filter reports on these network ids (ASN, RFC 1771)
- Amount
amountnumber - Top X of buckets to returnFrom 10 to 512.
- Countries
countrieslist - Country ids to filter on
- Companies
companieslist - Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
- Cities
citieslist - [BETA] City ids to filter on
- Providers
providerslist - [BETA] Provider ids to filter on
- Indicators
indicatorslist - [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
- Slugs
slugslistRequired - Slug to filter on
- Location source
location_sourcetext - Filter on specific location source typesOne of:
ip,device. - Startdate
startdatedate 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`
- Enddate
enddatedate 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`
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Ne
nelist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Asn
asnlist - Filter reports on these network ids (ASN, RFC 1771)
- Providers
providerslist - [BETA] Provider ids to filter on
- Indicators
indicatorslist - [BETA] Indicator ids to filter on
- Cities
citieslist - [BETA] City ids to filter on
- Interval
intervaltext - Interval for the time based buckets, examples: 15m (15 minutes), 1m, 5m, 10m, 1h, 24h, 1d, 2d, etc.
- Offset
offsettext - 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
- Companies
companieslist - Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
- Countries
countrieslist - 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
- Site
site_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
- Company
company_idnumberRequired - Id for a company
- Startdate
startdatedate 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`
- Enddate
enddatedate 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 size
page_sizenumber - Amount of results per page, between 10 and 100, defaults to 10From 10 to 100.
- Page
pagetext - 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
- Company
company_idnumberRequired - Id for a company
- Peak attribution
peak_attributionnumber - See the attribution endpoint for more information about attribution enumsOne of:
0,1,2,3. - Peak user impact
peak_user_impactnumber - See the attribution endpoint for more information about user impact enumsOne of:
0,1,2,3. - Only active
only_activetrue/false - When true, only the active incident will be returned
- Startdate
startdatedate 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`
- Enddate
enddatedate 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
pagenumber - Requested page numberAt least 1.
- Page size
page_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
- Startdate
startdatedate 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`
- Enddate
enddatedate 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 active
only_activetrue/false - When true, only the active incident will be returned
- Peak attribution
peak_attributionnumber - See the attribution endpoint for more information about attribution enumsOne of:
0,1,2,3. - Peak user impact
peak_user_impactnumber - See the attribution endpoint for more information about user impact enumsOne of:
0,1,2,3. - Page
pagenumber - Requested page numberAt least 1.
- Page size
page_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
- Slugs
slugslistRequired - Slug to filter on
- Page
pagetext - 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 size
page_sizenumber - Amount of results per pageFrom 10 to 1000.
- Location source
location_sourcetext - Filter on specific location source typesOne of:
ip,device. - Startdate
startdatedate 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`
- Enddate
enddatedate 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`
- Sw
swlist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Ne
nelist - Bounds for the query. Latitude,longitude pair, comma seperated, eg: `5.4123,21.0012`
- Asn
asnlist - Filter reports on these network ids (ASN, RFC 1771)
- Companies
companieslist - Company ids to filter on. You can get a list of relevant company ids from the `/slugs/<slug>/companies` endpoint.
- Countries
countrieslist - Country ids to filter on
- Cities
citieslist - [BETA] City ids to filter on
- Providers
providerslist - [BETA] Provider ids to filter on
- Indicators
indicatorslist - [BETA] Indicator ids to filter on
- Max pages
max_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
- Slugs
slugslistRequired - Slug to filter on
- Fields
fieldslist - 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
- Fields
fieldslist - 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. - Name
nametext - Company name to filter for, this will be a partial match, case insensitive.
- Country
countrytext - Country to filter on, iso 2
- Category id
category_idnumber - Category id to filter on
- Slug
slugtext - Slug to filter on, full match
- Page
pagenumber - 1-indexed page number for paginated results.At least 1.
- Page size
page_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"
}
}
}