Skip to content

Read a randomly drawn sample of service tests

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/public/random-service-test
curl --request GET \  --url https://api.xovris.ai/v1/public/random-service-test

No token needed: anyone may call this.

Done.

Media typeapplication/json
object
protocol
required
One of:
object
id
required
string
registeredAt
required
string
beacon
required
object
chain
required
string
round
required
number
fallsAt
required
string
fallback
required
string
Allowed values: nist-beacon-2.0
strata
required
Array<object>
object
id
required
string
Allowed values: A_documented_api B_mcp_server C_signin_web
frames
required
Array<object>
object
name
required
string
url
required
string
sha256
required
string
size
required
number
frameSize
required
number
n
required
number
timeCapMinutes
required
number
recheckHours
required
number
exclusions
required
object
E1
required
string
E2
required
string
E3
required
string
E4
required
string
E5
required
string
gate
required
object
minN
required
number
Allowed values: 300
minObserved
required
number
Allowed values: 0.99
minWilsonLower
required
number
Allowed values: 0.97
maxAgeDays
required
number
Allowed values: 60
latest
required
One of:
object
protocolId
required
string
drawnAt
required
string
completedAt
required
One of:
string
ageDays
required
One of:
number
strata
required
Array<object>
object
valid
required
number
connected
required
number
rate
required
One of:
number
wilson
required
One of:
object
lower
required
number
upper
required
number
id
required
string
Allowed values: A_documented_api B_mcp_server C_signin_web
excluded
required
object
E1
required
number
E2
required
number
E3
required
number
E4
required
number
E5
required
number
overall
required
object
valid
required
number
connected
required
number
rate
required
One of:
number
wilson
required
One of:
object
lower
required
number
upper
required
number
worstCase
required
object
valid
required
number
connected
required
number
rate
required
One of:
number
wilson
required
One of:
object
lower
required
number
upper
required
number
pending
required
number
gate
required
object
open
required
boolean
reasons
required
Array<string>
results
required
Array<object>
object
stratum
required
string
Allowed values: A_documented_api B_mcp_server C_signin_web
key
required
string
interfaces
required
Array<string>
outcome
required
string
Allowed values: failed connected excluded
failure
required
One of:
string
Allowed values: provider_refused timed_out authentication wrong_or_missing_data not_durable
exclusion
required
One of:
string
Allowed values: E1 E2 E3 E4 E5
xovrisSeconds
required
One of:
number
humanActs
required
Array<object>
object
kind
required
string
count
required
number
waitSeconds
required
number
recheck24h
required
string
Allowed values: failed passed pending

Example

{  "protocol": {    "id": "string",    "registeredAt": "string",    "beacon": {      "chain": "string",      "round": 1,      "fallsAt": "string",      "fallback": "nist-beacon-2.0"    },    "strata": [      {        "id": "A_documented_api",        "frames": [          {            "name": "string",            "url": "string",            "sha256": "string",            "size": 1          }        ],        "frameSize": 1,        "n": 1      }    ],    "timeCapMinutes": 1,    "recheckHours": 1  },  "exclusions": {    "E1": "string",    "E2": "string",    "E3": "string",    "E4": "string",    "E5": "string"  },  "gate": {    "minN": 300,    "minObserved": 0.99,    "minWilsonLower": 0.97,    "maxAgeDays": 60  },  "latest": {    "protocolId": "string",    "drawnAt": "string",    "completedAt": "string",    "ageDays": 1,    "strata": [      {        "valid": 1,        "connected": 1,        "rate": 1,        "wilson": {          "lower": 1,          "upper": 1        },        "id": "A_documented_api",        "excluded": {          "E1": 1,          "E2": 1,          "E3": 1,          "E4": 1,          "E5": 1        }      }    ],    "overall": {      "valid": 1,      "connected": 1,      "rate": 1,      "wilson": {        "lower": 1,        "upper": 1      }    },    "worstCase": {      "valid": 1,      "connected": 1,      "rate": 1,      "wilson": {        "lower": 1,        "upper": 1      }    },    "pending": 1,    "gate": {      "open": true,      "reasons": [        "string"      ]    }  },  "results": [    {      "stratum": "A_documented_api",      "key": "string",      "interfaces": [        "string"      ],      "outcome": "failed",      "failure": "provider_refused",      "exclusion": "E1",      "xovrisSeconds": 1,      "humanActs": [        {          "kind": "string",          "count": 1,          "waitSeconds": 1        }      ],      "recheck24h": "failed"    }  ]}

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.