Join 34,000+ subscribers and receive articles from our blog about software quality, testing, QA and security.

API to get list of all Test Runs assigned to a specific Test Plan


I am looking for an API, that will give me a list of all Test Runs assigned to a specific Test Plan. Something like GET index.php?/api/v2/get_runs/:plan_id. So far I was able to find only these:

  • GET index.php?/api/v2/get_runs/:project_id (but that works only on Test Runs that are not part of Test Plan)
  • GET index.php?/api/v2/get_plans/:project_id (but that returns only the plans, and I need to get one level deeper)
    Our structure of tests is Project > Test Plan > Test Run, so without this I am a bit lost. Any ideas please?


Hi Michal,

Thanks for your posting. You can simply use get_plan for this and this returns all test runs/configurations etc. for a test plan:

I hope this helps!



hello tobias,Can you please look into TestRail API Parameter Issue


Hello ,
I am trying to add test result into testRail using java + TestNG .
and I am successfully done that but some how i am not able to give proper value in actual result and content .
below is my code

Map data = new HashMap();
data.put(“case_id”, new Integer(36540));
data.put(“status_id”, new Integer(1));
data.put(“expected”, expected);
data.put(“elapsed”, “5m”);
data.put(“title”, title);
data.put(“actual”, “Login Passed”);

List list = new ArrayList();
Map d = new HashMap();
d.put(“results”, list);

client.sendPost(“add_results_for_cases/347”, d);

I am able to mark the test case as pass but not able to add actual result and contect parameter …


Hi Dhaval,

Please see: TestRail API Parameter Issue