from metadata.sdk import configure
from metadata.sdk.entities import TestSuites

configure(
    host="https://your-company.getcollate.io/api",
    jwt_token="your-jwt-token"
)

# List first page
suites = TestSuites.list(limit=50)
for ts in suites.data:
    print(f"{ts.displayName} (executable: {ts.executable})")

# List all with auto-pagination
for ts in TestSuites.list_all():
    print(f"{ts.fullyQualifiedName}")

# Filter by type
logical_suites = TestSuites.list(
    testSuiteType="logical",
    fields=["owners", "tests"],
    limit=50
)

for ts in logical_suites.data:
    print(f"{ts.displayName}")

{
  "data": [
    {
      "id": "e86a9a11-852f-4bac-b5a7-993b2bbbb572",
      "name": "b5fcae09-02c2-4c0b-8c4a-5b52d650e592",
      "displayName": "Data Contract - dim_address_comprehensive_contract",
      "fullyQualifiedName": "b5fcae09-02c2-4c0b-8c4a-5b52d650e592",
      "version": 0.1,
      "updatedAt": 1769982757893,
      "updatedBy": "admin",
      "deleted": false,
      "owners": [],
      "executable": true
    }
  ],
  "paging": {
    "after": "...",
    "total": 5
  }
}