Milestones

Milestones in Qualflare represent project milestones or release targets. Test launches can be associated with milestones for organized tracking across sprints and releases.

qf milestones list

List all milestones in the project, with optional search and sorting.

Syntax

qf milestones list [flags]

Flags

Flag	Type	Default	Description
--query	string	—	Search query to filter milestones by name or description
--page	int	0	Page number for paginated results
--sort-by	string	—	Field name to sort results by
--sort-desc	bool	false	Sort results in descending order
--api-key	string	—	API key for authentication. Overrides QF_API_KEY environment variable

Examples

# List all milestones
qf milestones list

# Search for a milestone by name
qf milestones list --query "v2.0"

# Search for release milestones
qf milestones list --query "release"

# Sort by due date, soonest first
qf milestones list --sort-by dueDate

# Sort by due date, furthest out first
qf milestones list --sort-by dueDate --sort-desc

# Paginate through results
qf milestones list --page 2

Example Output

{
  "milestones": [
    {
      "seq": 3,
      "title": "v2.0 Release",
      "description": "Feature-complete release with new payment flow",
      "dueDate": "2026-04-30T00:00:00Z",
      "createdAt": "2026-02-01T10:00:00Z"
    }
  ]
}

---

qf milestone get <seq>

Fetch full details for a single milestone by its sequence number.

Syntax

qf milestone get <seq>

Arguments

Argument	Description
seq	The sequence number of the milestone to retrieve

Flags

Flag	Type	Default	Description
--api-key	string	—	API key for authentication. Overrides QF_API_KEY environment variable

Examples

# Get milestone with sequence number 3
qf milestone get 3

# Get milestone and check the due date
qf milestone get 3 | jq '.dueDate'

Example Output

{
  "seq": 3,
  "title": "v2.0 Release",
  "description": "Feature-complete release with new payment flow",
  "dueDate": "2026-04-30T00:00:00Z",
  "createdAt": "2026-02-01T10:00:00Z"
}

Working with JSON Output

All milestone commands output pretty-printed JSON to stdout, making them easy to pipe to jq for filtering and transformation.

# Find a milestone by exact title
qf milestones list | jq '.milestones[] | select(.title == "v2.0 Release")'

# List all milestone titles and their due dates
qf milestones list | jq '.milestones[] | {title, dueDate}'

# Find milestones due after a specific date
qf milestones list | jq '.milestones[] | select(.dueDate > "2026-04-01T00:00:00Z") | {seq, title, dueDate}'

# Get all milestone sequence numbers
qf milestones list | jq '[.milestones[].seq]'

# Count total milestones
qf milestones list | jq '.milestones | length'

Filtering Launches by Milestone

Once you know a milestone's sequence number, you can filter test launches by it using the launches command:

# List all launches associated with milestone 3
qf launches list --milestone 3

This makes it easy to review all test activity tied to a specific release target.

See Also

• Collect — Upload test results and associate them with a milestone
• Defects — List and inspect defect records linked to failed test cases
• Other Commands — Utility commands including validate and list-formats
• Configuration — Environment variables and global flags reference