---
title: "List enterprise connection test runs"
method: GET
path: "/enterprise_connections/{enterprise_connection_id}/test_runs"
tags: ["Enterprise Connections"]
---

# List enterprise connection test runs

`GET /enterprise_connections/{enterprise_connection_id}/test_runs`

## Request

- Base URL: `https://api.clerk.com/v1`
- URL: `https://api.clerk.com/v1/enterprise_connections/{enterprise_connection_id}/test_runs`
- Auth: HTTP bearer

Returns a paginated list of SAML or OIDC debug test runs for an enterprise connection.

## Path parameters

- `enterprise_connection_id` string, required

## Query parameters

- `status` string[]
- `limit` integer
- `offset` integer

## Response `200`

A list of enterprise connection test runs

- EnterpriseConnectionTestRuns
  - `data` EnterpriseConnectionTestRun[], required
    - `id` string, required: The test run ID
    - `status` 'pending' | 'success' | 'failed', required: The status of the test run
    - `connection_type` 'saml' | 'oauth', required: The type of enterprise connection the test run was performed against
    - `parsed_user_info` object, nullable: The user information parsed from the IdP response
      - `email_address` string
      - `first_name` string
      - `last_name` string
      - `user_id` string
    - `logs` object[]: Log entries captured during the test run
      - `level` string, required
      - `code` string
      - `short_message` string
      - `message` string, required
    - `saml` object, nullable: SAML-specific metadata, present for SAML connections
      - `saml_request` string
      - `saml_response` string
      - `relay_state` string
    - `oauth` object, nullable: OAuth-specific metadata, present for OIDC connections
      - `id_token` string
      - `access_token` string
      - `user_info` string
    - `created_at` integer, required: Unix timestamp in milliseconds when the test run was created
  - `total_count` integer, required: Total number of test runs

## Other responses

- `402`: Payment required
- `403`: Authorization invalid
- `404`: Resource not found
- `422`: Invalid request parameters

## Changes

- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/enterprise_connections/:enterprise_connection_id/test_runs/get.md)

---

[API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [All operations](https://skmtc.dev/clerk/apis/clerk-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clerk/apis/clerk-backend-api/revisions/a490313abffa?raw)