Skip to content

Read what will fail before it does

What you can call today

Every example here runs against api.xovris.ai with a key from your account’s settings. GET /v1/health and GET /v1/public/status answer without one.

GET
/v1/forecasts
curl --request GET \  --url https://api.xovris.ai/v1/forecasts \  --header 'Authorization: Bearer <token>'

A token that can read is enough.

Done.

Media typeapplication/json
object
asOf
required
string
readAt
required
string
accuracy
required
object
unread
string
measuredOn
required
string
Allowed values: 2026-10-11
repeats
required
number
Allowed values: 5
byKind
required
object
disks
required
object
prevented
required
number
Allowed values: 72
planted
required
number
Allowed values: 72
quiet
required
number
Allowed values: 180
controls
required
number
Allowed values: 180
every other kind
required
object
prevented
required
number
Allowed values: 108
planted
required
number
Allowed values: 108
quiet
required
number
Allowed values: 36
controls
required
number
Allowed values: 36
backups
required
object
prevented
required
number
Allowed values: 36
planted
required
number
Allowed values: 36
quiet
required
number
Allowed values: 36
controls
required
number
Allowed values: 36
capacity
required
object
prevented
required
number
Allowed values: 36
planted
required
number
Allowed values: 36
quiet
required
number
Allowed values: 36
controls
required
number
Allowed values: 36
certificates
required
object
prevented
required
number
Allowed values: 72
planted
required
number
Allowed values: 72
quiet
required
number
Allowed values: 36
controls
required
number
Allowed values: 36
domain expiry
required
object
prevented
required
number
Allowed values: 72
planted
required
number
Allowed values: 72
quiet
required
number
Allowed values: 36
controls
required
number
Allowed values: 36
DNS
required
object
prevented
required
number
Allowed values: 72
planted
required
number
Allowed values: 72
quiet
required
number
Allowed values: 72
controls
required
number
Allowed values: 72
email delivery
required
object
prevented
required
number
Allowed values: 72
planted
required
number
Allowed values: 72
quiet
required
number
Allowed values: 72
controls
required
number
Allowed values: 72
providers
required
object
prevented
required
number
Allowed values: 36
planted
required
number
Allowed values: 36
quiet
required
number
Allowed values: 36
controls
required
number
Allowed values: 36
dependencies
required
object
prevented
required
number
Allowed values: 36
planted
required
number
Allowed values: 36
quiet
required
number
Allowed values: 36
controls
required
number
Allowed values: 36
security
required
object
prevented
required
number
Allowed values: 72
planted
required
number
Allowed values: 72
quiet
required
number
Allowed values: 72
controls
required
number
Allowed values: 72
here
required
Array<object>
object
kind
required
string
raised
required
number
in_time
required
number
past_due
required
number
open
required
number
forecasts
required
Array<object>
object
kind
required
string
Allowed values: domain custom battery secret contract certificate trial quota disk card licence end_of_support backup_storage subscription disk_health bounce_rate spam_rate dnssec_signatures api_version_sunset
label
required
string
feature
required
string
Allowed values: forecast.expiry_dates forecast.devices
when
required
string
earliest
required
string
latest
required
One of:
string
confidence
required
string
Allowed values: high medium low
what
required
string
fix
required
object
action
required
string
safe
required
string
Allowed values: renew_in_window caa_allow_issuer dns_wait_raise dns_key_reissue renew_or_confirm_auto card_update_at_registrar clear_temp_then_show back_up_then_replace plan_battery_and_charging prune_past_keep_or_add_space raise_limit_or_slow_calls point_to_card_update renew_or_auto_renew check_renewal decide_before_day pause_and_suppress slow_bulk_sends resign_zone move_version_in_copy upgrade_proven_in_sandbox issue_switch_retire act_before_limit
at
required
string
press
object
method
required
string
Allowed values: POST
path
required
string
body
required
object
key
additional properties
evidence
required
Array<string>
accuracy
required
One of:
object
failureKind
required
string
prevented
required
number
planted
required
number
quiet
required
number
controls
required
number
measuredOn
required
string
Allowed values: 2026-10-11
repeats
required
number
Allowed values: 5
record
required
One of:
object
raised
required
number
inTime
required
number
pastDue
required
number
open
required
number
items
required
Array<object>
object
kind
required
string
Allowed values: domain custom battery secret contract certificate trial quota disk card licence end_of_support backup_storage subscription disk_health bounce_rate spam_rate dnssec_signatures api_version_sunset
label
required
string
feature
required
string
Allowed values: forecast.expiry_dates forecast.devices
when
required
string
earliest
required
string
latest
required
One of:
string
confidence
required
string
Allowed values: high medium low
what
required
string
fix
required
object
action
required
string
safe
required
string
Allowed values: renew_in_window caa_allow_issuer dns_wait_raise dns_key_reissue renew_or_confirm_auto card_update_at_registrar clear_temp_then_show back_up_then_replace plan_battery_and_charging prune_past_keep_or_add_space raise_limit_or_slow_calls point_to_card_update renew_or_auto_renew check_renewal decide_before_day pause_and_suppress slow_bulk_sends resign_zone move_version_in_copy upgrade_proven_in_sandbox issue_switch_retire act_before_limit
at
required
string
press
object
method
required
string
Allowed values: POST
path
required
string
body
required
object
key
additional properties
evidence
required
Array<string>
accuracy
required
One of:
object
failureKind
required
string
prevented
required
number
planted
required
number
quiet
required
number
controls
required
number
measuredOn
required
string
Allowed values: 2026-10-11
repeats
required
number
Allowed values: 5
record
required
One of:
object
raised
required
number
inTime
required
number
pastDue
required
number
open
required
number
locked
required
Array<object>
object
count
required
number
message
required
string
next
required
string
plan
required
One of:
string
feature
required
string
notForecast
required
Array<object>
object
label
required
string
reason
required
string
watch
required
One of:
object
releasesUnread
string
releases
required
Array<object>
object
service
required
string
release
required
string
against
required
string
firstSeen
required
string
lastSeen
required
string
concurrent
required
boolean
paths
required
number
stats
required
object
seen
required
number
estimated
required
number
meanMs
required
One of:
number
p50Ms
required
One of:
number
p95Ms
required
One of:
number
p99Ms
required
One of:
number
errorRate
required
One of:
number
costPerRequestMicroUsd
required
One of:
number
baseline
required
object
seen
required
number
estimated
required
number
meanMs
required
One of:
number
p50Ms
required
One of:
number
p95Ms
required
One of:
number
p99Ms
required
One of:
number
errorRate
required
One of:
number
costPerRequestMicroUsd
required
One of:
number
errorsZ
required
number
latency
required
object
regressed
required
boolean
p99Rise
required
One of:
number
z
required
number
faulty
required
Array<string>
Allowed values: errors latency
sentence
required
string
traces
required
number
drifts
required
Array<object>
object
kind
required
string
Allowed values: custom memory temperature latency error_rate queue retries dns_lookup tls_failures power_backup
label
required
string
since
required
string
z
required
number
strength
required
number
outageEarliest
required
One of:
string
words
required
string
evidence
required
Array<string>
anomalies
required
Array<object>
object
kind
required
string
Allowed values: custom memory temperature latency error_rate queue retries dns_lookup tls_failures power_backup
label
required
string
since
required
string
z
required
number
words
required
string
evidence
required
Array<string>
notJudged
required
Array<object>
object
label
required
string
reason
required
string
series
required
number
early
required
object
warnings
required
Array<object>
object
area
required
string
Allowed values: weak outside people security change calendar drift upstream people_say preflight near_miss
kind
string
key
required
string
label
required
string
words
required
string
sure
required
number
sureWords
required
string
hoursUntil
required
One of:
number
untilWords
required
string
fix
required
string
severity
required
string
Allowed values: high medium low
evidence
required
Array<string>
undo
object
change
required
string
targets
required
Array<string>
recovery
string
Allowed values: watching recovered not_recovered
rules
required
Array<object>
object
label
required
string
z
required
number
leadHours
required
number
from
required
string
notJudged
required
Array<string>

Example

{  "asOf": "string",  "readAt": "string",  "accuracy": {    "unread": "string",    "measuredOn": "2026-10-11",    "repeats": 5,    "byKind": {      "disks": {        "prevented": 72,        "planted": 72,        "quiet": 180,        "controls": 180      },      "every other kind": {        "prevented": 108,        "planted": 108,        "quiet": 36,        "controls": 36      },      "backups": {        "prevented": 36,        "planted": 36,        "quiet": 36,        "controls": 36      },      "capacity": {        "prevented": 36,        "planted": 36,        "quiet": 36,        "controls": 36      },      "certificates": {        "prevented": 72,        "planted": 72,        "quiet": 36,        "controls": 36      },      "domain expiry": {        "prevented": 72,        "planted": 72,        "quiet": 36,        "controls": 36      },      "DNS": {        "prevented": 72,        "planted": 72,        "quiet": 72,        "controls": 72      },      "email delivery": {        "prevented": 72,        "planted": 72,        "quiet": 72,        "controls": 72      },      "providers": {        "prevented": 36,        "planted": 36,        "quiet": 36,        "controls": 36      },      "dependencies": {        "prevented": 36,        "planted": 36,        "quiet": 36,        "controls": 36      },      "security": {        "prevented": 72,        "planted": 72,        "quiet": 72,        "controls": 72      }    },    "here": [      {        "kind": "string",        "raised": 1,        "in_time": 1,        "past_due": 1,        "open": 1      }    ]  },  "forecasts": [    {      "kind": "domain",      "label": "string",      "feature": "forecast.expiry_dates",      "when": "string",      "earliest": "string",      "latest": "string",      "confidence": "high",      "what": "string",      "fix": {        "action": "string",        "safe": "renew_in_window",        "at": "string",        "press": {          "method": "POST",          "path": "string",          "body": {}        }      },      "evidence": [        "string"      ],      "accuracy": {        "failureKind": "string",        "prevented": 1,        "planted": 1,        "quiet": 1,        "controls": 1,        "measuredOn": "2026-10-11",        "repeats": 5      },      "record": {        "raised": 1,        "inTime": 1,        "pastDue": 1,        "open": 1      }    }  ],  "items": [    {      "kind": "domain",      "label": "string",      "feature": "forecast.expiry_dates",      "when": "string",      "earliest": "string",      "latest": "string",      "confidence": "high",      "what": "string",      "fix": {        "action": "string",        "safe": "renew_in_window",        "at": "string",        "press": {          "method": "POST",          "path": "string",          "body": {}        }      },      "evidence": [        "string"      ],      "accuracy": {        "failureKind": "string",        "prevented": 1,        "planted": 1,        "quiet": 1,        "controls": 1,        "measuredOn": "2026-10-11",        "repeats": 5      },      "record": {        "raised": 1,        "inTime": 1,        "pastDue": 1,        "open": 1      }    }  ],  "locked": [    {      "count": 1,      "message": "string",      "next": "string",      "plan": "string",      "feature": "string"    }  ],  "notForecast": [    {      "label": "string",      "reason": "string"    }  ],  "watch": {    "releasesUnread": "string",    "releases": [      {        "service": "string",        "release": "string",        "against": "string",        "firstSeen": "string",        "lastSeen": "string",        "concurrent": true,        "paths": 1,        "stats": {          "seen": 1,          "estimated": 1,          "meanMs": 1,          "p50Ms": 1,          "p95Ms": 1,          "p99Ms": 1,          "errorRate": 1,          "costPerRequestMicroUsd": 1        },        "baseline": {          "seen": 1,          "estimated": 1,          "meanMs": 1,          "p50Ms": 1,          "p95Ms": 1,          "p99Ms": 1,          "errorRate": 1,          "costPerRequestMicroUsd": 1        },        "errorsZ": 1,        "latency": {          "regressed": true,          "p99Rise": 1,          "z": 1        },        "faulty": [          "errors"        ],        "sentence": "string"      }    ],    "traces": 1,    "drifts": [      {        "kind": "custom",        "label": "string",        "since": "string",        "z": 1,        "strength": 1,        "outageEarliest": "string",        "words": "string",        "evidence": [          "string"        ]      }    ],    "anomalies": [      {        "kind": "custom",        "label": "string",        "since": "string",        "z": 1,        "words": "string",        "evidence": [          "string"        ]      }    ],    "notJudged": [      {        "label": "string",        "reason": "string"      }    ],    "series": 1  },  "early": {    "warnings": [      {        "area": "weak",        "kind": "string",        "key": "string",        "label": "string",        "words": "string",        "sure": 1,        "sureWords": "string",        "hoursUntil": 1,        "untilWords": "string",        "fix": "string",        "severity": "high",        "evidence": [          "string"        ],        "undo": {          "change": "string",          "targets": [            "string"          ]        },        "recovery": "watching"      }    ],    "rules": [      {        "label": "string",        "z": 1,        "leadHours": 1,        "from": "string"      }    ],    "notJudged": [      "string"    ]  }}

Not signed in: the token is missing, expired or revoked. The answer says how to get a new one.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Signed in, but this token or role may not do this. The answer names the permission it needs.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Nothing with that id here, or it belongs to another workspace. Nothing was changed.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Any other refusal or failure. The answer says what happened and what to do next.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Ask Xovris

Open the full page

Your data is never used to train our AI. How your data is kept

A problem is called fixed only once it works again. How each fix is checked

XOVRIS LTD, registered in England and Wales, company number 17499910. Registered office: 66 Paul Street, London EC2A 4NA.