Exporting Test Cases

Export all test case definitions from your project, including names, goals, expected results, and step-by-step instructions. This is useful for migrating to another test management tool (for example Jira with Xray or Zephyr), keeping external backups, or building custom reports.

What Gets Exported

The List Test Cases endpoint returns published test cases. Each test case includes its name, goal, expected result, labels, enabled state, classification, and the most recent run status. When you pass includeSteps=true, each test case also includes a steps array with step-by-step instructions. See the List Test Cases reference for the full response schema.

Steps are opt-in via the includeSteps query parameter to keep default responses small. Test cases that are defined by a goal only (without a step breakdown) return an empty steps array.

Export via the API

Pass includeSteps=true to include the full step definitions:

curl "https://api.qa.tech/v1/test-cases?includeSteps=true&limit=1000" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

The endpoint returns up to 1000 test cases per request. If your project has more, page through the results with offset:

curl "https://api.qa.tech/v1/test-cases?includeSteps=true&limit=1000&offset=1000" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

See the API Introduction for how to create an API token. With an organization-scoped key, also pass projectShortId as a query parameter.

Export via the CLI

The qatech CLI wraps the same endpoint:

qatech test-cases --include-steps --json > test-cases.json

See qatech test-cases for all options.

Converting to CSV

Many test management importers expect one row per step. This jq one-liner converts the JSON export into that shape:

qatech test-cases --include-steps --json | jq -r '
  ["Test Case ID", "Test Case Name", "Step Number", "Step Instruction", "Step Expected Result"],
  (.testCases[] | . as $tc | .steps // [] | to_entries[] |
    [$tc.id, $tc.name, (.key + 1), .value.instruction, (.value.expectedResult // "")])
  | @csv' > test-case-steps.csv

For a one-row-per-test-case shape with numbered steps in a single column:

qatech test-cases --include-steps --json | jq -r '
  ["Test Case ID", "Name", "Goal", "Expected Result", "Steps"],
  (.testCases[] |
    [.id, .name, (.goal // ""), (.expectedResult // ""),
     ([.steps // [] | to_entries[] | "\(.key + 1). \(.value.instruction)"] | join("\n"))])
  | @csv' > test-cases.csv

List Test Cases - Full endpoint reference
qatech test-cases - CLI command reference
API Introduction - Authentication and ID reference

Overview

Endpoints

What Gets Exported

Export via the API

Export via the CLI

Converting to CSV

​What Gets Exported

​Export via the API

​Export via the CLI

​Converting to CSV

​Related

What Gets Exported

Export via the API

Export via the CLI

Converting to CSV

Related