---
title: "Get-CatTestList"
description: "Get-CatTestList — the lists the open project loads tests from."
url: "https://docs.justcat.it/reference/powershell-module/get-cattestlist/"
---
# Get-CatTestList

## Synopsis

```powershell
Get-CatTestList
```

## Parameters

None (common parameters only).

## What it does

Writes the project's test lists: the project file's own implicit list and every `Test list` the project declares (a YAML file, a database table, an Excel sheet, …), each with its provider and connection. Use it to see *where* tests come from; `Get-CatTest` shows the tests themselves, with `TestListID` pointing back here.

## Output

One `List<TestList>` object. Each item has `TestListID`, `Name`, `Order`, `ProviderNameAndVersion`, `ConnectionString`, `Query`, `IsImplicit` (the project file's own list), `IsEditable`, `Settings`.

## Errors

`There is no CAT project open. Use Open-CatProject to open it.` when nothing is open.

## Examples

```powershell
Open-CatProject
(Get-CatTestList) | Format-Table Order, Name, ProviderNameAndVersion

# how many tests came from each list
$lists = Get-CatTestList
$tests = Get-CatTest
foreach ($l in $lists) { "$($l.Name): $(($tests | Where-Object TestListID -eq $l.TestListID).Count)" }
```

## Related

- [Introduction](https://docs.justcat.it/reference/powershell-module/introduction/ "Introduction") — session model, logging, errors, sign-in.
- [Lists](https://docs.justcat.it/reference/project-file/lists/ "Lists").
- [`Get-CatTest`](https://docs.justcat.it/reference/powershell-module/get-cattest/ "Get-CatTest").