---
title: "Query external TCM bindings"
method: GET
path: "/tcm/external/bindings"
tags: ["TestCaseManagement"]
---

# Query external TCM bindings

`GET /tcm/external/bindings`

Queries external test case management bindings

## Query parameters

- `workspace_integration_id` string, required
- `external_tcm_platform` 'xray' — Supported external test case management platforms
- `external_entity_id` string
- `mabl_entity_type` 'test' | 'test_case' | 'plan' | 'plan_run' — Types of mabl entities that can be bound to external TCM.
- `mabl_entity_id` string
- `limit` integer

## Response `200`

External TCM bindings matching the query

- ExternalTcmBindingQueryResult — Query result containing external TCM bindings
  - `bindings` ExternalTcmBinding[], required — All external TCM bindings that matched the query
    - `external_tcm_binding_id` string — Unique identifier for the binding
    - `workspace_id` string — Unique identifier for the associated Workspace
    - `workspace_integration_id` string — Unique identifier for the associated WorkspaceIntegration
    - `external_tcm_platform` 'xray' — Supported external test case management platforms
    - `external_entity_id` string — Unique identifier for the associated entity in the external test case management solution
    - `mabl_entity_type` 'test' | 'test_case' | 'plan' | 'plan_run' — Types of mabl entities that can be bound to external TCM.
    - `mabl_entity_id` string — Unique identifier for the associated mabl entity
    - `created_time` integer — Time at which the binding was created
    - `created_by_id` string — The ID of the user who created this binding
    - `auto_sync_enabled` boolean — Per-binding automatic result synchronization setting

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Entity not found
- `default` — Unknown error

---

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