---
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`

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

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/75df3a43fcb2/schema)