get_cases
Retrieve test cases from TestRail projects and suites with filtering options for creation date, priority, milestone, and custom criteria to organize testing workflows.
Instructions
Get a list of test cases for a project or specific test suite with optional filtering and pagination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | TestRail project ID | |
| suite_id | No | TestRail suite ID (optional if project is in single suite mode) | |
| created_after | No | Only return test cases created after this date (as UNIX timestamp) | |
| created_before | No | Only return test cases created before this date (as UNIX timestamp) | |
| created_by | No | A list of creator user IDs to filter by | |
| filter | No | Only return cases with matching filter string in the case title | |
| limit | No | The number of test cases to return (max 250, default 250) | |
| milestone_id | No | A list of milestone IDs to filter by | |
| offset | No | Where to start counting the test cases from (pagination offset) | |
| priority_id | No | A list of priority IDs to filter by | |
| refs | No | A single Reference ID (e.g. TR-1, 4291, etc.) | |
| section_id | No | The ID of a test case section | |
| template_id | No | A list of template IDs to filter by | |
| type_id | No | A list of case type IDs to filter by | |
| updated_after | No | Only return test cases updated after this date (as UNIX timestamp) | |
| updated_before | No | Only return test cases updated before this date (as UNIX timestamp) | |
| updated_by | No | A user ID who updated test cases to filter by | |
| label_id | No | A list of label IDs to filter by |