List Clerk enterprise connection test runs

List SSO debug test runs for an enterprise connection.

← All Clerk endpoints · Capability overview

GET/v1/clerk/enterprise-connections/{connection_id}/test-runs

https://api.vee3.io/v1/clerk/enterprise-connections/{connection_id}/test-runs

5 tokens

List SSO debug test runs for an enterprise connection.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

clerk.list_enterprise_connection_test_runs

Parameters5 fields

clerk_instance_idstringOptional

Clerk instance id (ins_...) from clerk.get_connected_accounts. Omit to use the default connected account.

connection_idstringRequired

Clerk enterprise connection id (entc_...) to retrieve, update, delete, or test.

limitintegerOptional

Maximum number of results to return (1–500).

Default: 10 · min 1, max 500

offsetintegerOptional

Number of results to skip before returning.

Default: 0 · min 0

statusarrayOptional

Filter by test run status: "pending", "success", or "failed".

Response16 fields

test_runsarrayitems

14 fields

Enterprise connection SSO test runs.

idstring

Enterprise connection test run id.

statusstring

Test run status: "pending", "success", or "failed".

connection_typestring

Connection type tested: "saml" or "oauth".

created_atinteger

Unix timestamp in milliseconds when the test run was created.

parsed_user_infoobject

4 fields

User attributes parsed from the IdP response.

email_addressstring

Email address parsed from the IdP response.

first_namestring

First name parsed from the IdP response.

last_namestring

Last name parsed from the IdP response.

user_idstring

User id parsed from the IdP response.

logsarrayitems

4 fields

Log entries captured during the test run.

levelstring

Log level (for example info, warn, or error).

messagestring

Log message text.

codestring

Optional machine-readable log code.

short_messagestring

Optional short log summary.

total_countinteger

Total number of test runs matching the query.

HTTP errors: clerk_connection_required, clerk_connection_not_found, clerk_connection_invalid, validation_error, unauthorized, payment_required

Example request

Python

import requests

url = "https://api.vee3.io/v1/clerk/enterprise-connections/{connection_id}/test-runs"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "connection_id": "conn_2abc123"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200SSO test runs for an enterprise connection.

enterprise_connection_test_run_list.json

{
  "test_runs": [
    {
      "id": "ectr_2abc123",
      "status": "success",
      "connection_type": "saml",
      "created_at": 1710000000000,
      "parsed_user_info": {
        "email_address": "user@acme.com",
        "first_name": "Jane",
        "last_name": "Doe"
      },
      "logs": [
        {
          "level": "info",
          "message": "SAML response validated successfully."
        }
      ]
    }
  ],
  "total_count": 1
}