get_runs
Retrieve test runs for a specific project with filtering options like date ranges, creators, completion status, and pagination controls. Excludes test runs that are part of test plans.
Instructions
Get a list of test runs for a project with optional filtering and pagination. Only returns test runs that are not part of a test plan.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | TestRail project ID | |
| created_after | No | Only return test runs created after this date (as UNIX timestamp) | |
| created_before | No | Only return test runs created before this date (as UNIX timestamp) | |
| created_by | No | A comma-separated list of creators (user IDs) to filter by | |
| is_completed | No | 1 to return completed test runs only. 0 to return active test runs only | |
| limit | No | The number of test runs to return (max 250, default 250) | |
| milestone_id | No | A comma-separated list of milestone IDs to filter by | |
| offset | No | Where to start counting the test runs from (pagination offset) | |
| refs_filter | No | A single Reference ID (e.g. TR-a, 4291, etc.) | |
| suite_id | No | A comma-separated list of test suite IDs to filter by |
Input Schema (JSON Schema)
{
"properties": {
"created_after": {
"description": "Only return test runs created after this date (as UNIX timestamp)",
"type": "integer"
},
"created_before": {
"description": "Only return test runs created before this date (as UNIX timestamp)",
"type": "integer"
},
"created_by": {
"description": "A comma-separated list of creators (user IDs) to filter by",
"items": {
"exclusiveMinimum": 0,
"type": "integer"
},
"type": "array"
},
"is_completed": {
"description": "1 to return completed test runs only. 0 to return active test runs only",
"type": "boolean"
},
"limit": {
"description": "The number of test runs to return (max 250, default 250)",
"exclusiveMinimum": 0,
"type": "integer"
},
"milestone_id": {
"description": "A comma-separated list of milestone IDs to filter by",
"items": {
"exclusiveMinimum": 0,
"type": "integer"
},
"type": "array"
},
"offset": {
"description": "Where to start counting the test runs from (pagination offset)",
"minimum": 0,
"type": "integer"
},
"project_id": {
"description": "TestRail project ID",
"exclusiveMinimum": 0,
"type": "integer"
},
"refs_filter": {
"description": "A single Reference ID (e.g. TR-a, 4291, etc.)",
"type": "string"
},
"suite_id": {
"description": "A comma-separated list of test suite IDs to filter by",
"items": {
"exclusiveMinimum": 0,
"type": "integer"
},
"type": "array"
}
},
"required": [
"project_id"
],
"type": "object"
}