---
description: Run API tests
---
# Run Checkmate Tests
Run API tests against the configured base URL.
## Usage
```bash
# Run all test specs
cm test run
# Run specific spec by name
cm test run counters
# Run with verbose output
cm test run -v
# Run specific test within a spec
cm test run counters --test counter_by_email
```
## Understanding Results
Test results are output as JSON with:
- `summary`: Total/passed/failed/errors counts
- `tests`: Array of individual test results
- `failures`: Details about what went wrong
Exit code is 1 if any tests fail.
## After Running
- Results are saved to `.checkmate/runs/runs.jsonl`
- View history with `cm history`
- View specific run with `cm show <run-id>`