Skip to content
Dashboard
Theme
Theme

Latest test sign-in result with Connection Doctor output

GET /v1/connections/{conn}/test_result: Latest test sign-in result with Connection Doctor output.

View Markdown

GET /v1/connections/{conn}/test_result

The same result the setup portal shows. A failed test carries doctor with the plain-language cause and IdP-specific fix steps.

Scope
connections:read
Auth
Secret key (sk_…)
Since
1.0
  • conn string Required

  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

Errors share one shape; see the error code catalogue.

curl -X GET \
"https://api.ohauthcat.com/v1/connections/conn_01J9Z3K5V7W8X9Y0Z1A2B3C4D5/test_result" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY"
Response 200
{
"attempt_id": "sgn_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"started_at": "2026-01-15T09:30:00Z",
"tested_email": "jane@acme.com",
"state": "pending",
"checks": [
{
"check": "example_check",
"passed": true,
"error_code": "saml_signature_invalid",
"fix_guide_id": "01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"informational": true
}
],
"doctor": {
"error_code": "saml_signature_invalid",
"idp": "okta",
"cause": "The IdP signed the response with an unexpected certificate.",
"it_admin_message": "The IdP signed the response with an unexpected certificate.",
"fix_guide_id": "01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"steps": [
"acs"
]
}
}