Search API

You can use Zephyr Enterprise REST API to search for test cases, requirements, and executions programmatically.

GET http(s)://{ZEPHYR-SERVER}/flex/services/rest/latest/advancesearch?
      word=<text>
      &entitytype=<entitytype>
      &releaseid=<id>
      &zql=false
      &isascorder=true
      &order=<fieldname>
      &firstresult=0
      &maxresults=100
      &is_cfield=false

You can authenticate your requests by using one of the methods described in the Zephyr REST API topic.

You can specify the first element of the retrieved results and the number of items to show by using the firstresult and maxresults query parameters respectively. The firstresult parameter is zero-based, which means you need to specify 0 as the start position to begin with the first element. The sample request below will show a list of results starting from the first element, and the maximum number of retrieved items will be 100:

GET /flex/services/rest/latest/advancesearch?word=test&entitytype=testcase&releaseid=1&zql=false&firstresult=0&maxresults=100

On success, the operation returns status code 200 and a JSON object containing metadata and found results. The structure of these results varies depending on the sought-for entities, items and so on. Below is a sample response obtained when searching for an execution:

[
   {
      "firstResult": 0,
      "resultSize": 1,
      "results": [
         {
            "id": 147,     ----------------------------------- The RTS ID (the execution ID)
            "assignmentDate": "2020-09-15",
            "actualTime": 600,
            "versionId": "1",
            "comment": "This is a comment",
            "testerId": 5,
            "executedBy": 5,
            "tcrTreeTestcase": {
               "id": 308,  ----------------------------------- The TCR Catalog Tree TestCase ID (tctid)
               "tcrCatalogTreeId": 30,
               "revision": 9,
               "stateFlag": 0,
               "lastModifiedOn": 1600168120466,
               "versionNumber": 1,
               "createDatetime": 1600168114777,
               "createdById": 5,
               "modifiedById": 5,
               "testcase": {
                  "customProperties": {
                  },
                  "customProcessedProperties": {
                  },
                  "id": 165, ----------------------------------- The test case version ID
                  "name": "edited 159 testcase edit",
                  "description": "",
                  "lastModifiedOn": 1600169396082,
                  "creationDate": 1600128000000,
                  "createDatetime": 1600168102437,
                  "tcCreationDate": "09/15/2020",
                  "comments": "",
                  "isComplex": false,
                  "estimatedTime": 600,
                  "writerId": 0,
                  "creatorId": 5,
                  "lastUpdaterId": 5,
                  "oldId": 0,
                  "automated": false,
                  "customFieldProcessed": false,
                  "customFieldValues": [
                     
                  ],
                  "testcaseSequence": {
                     "seqNumber": 159
                  },
                  "testcaseId": 159, ----------------------------------- The test case ID
                  "versionNumber": 1,
                  "projectId": 3,
                  "testcaseType": "ORIGINAL",
                  "requirementIds": [
                     
                  ],
                  "projectName": "P1",
                  "requirementIdsNew": [
                     
                  ],
                  "creatorName": "John Smith",
                  "lastModifierName": "John Smith",
                  "automatedDefault": false,
                  "testcaseShared": false
               },
               "projectId": 3,
               "releaseId": 5,
               "isDerivedFromBDD": false,
               "orderId": 453,
               "maxVersionNumber": 1,
               "projectIdParam": 3,
               "original": false
            },
            "cyclePhaseId": 7,
            "lastTestResult": {
               "id": 58,
               "executionDate": 1600169404251,
               "execDate": "09/15/2020",
               "executionStatus": "4",
               "testerId": 5,
               "releaseTestScheduleId": 147,
               "createDatetime": 1600169404253,
               "modifiedDatetime": 1600169404250,
               "createdById": 5,
               "modifiedById": 5
            },
            "defects": [
               
            ],
            "attachmentCount": 0,
            "lastModifiedBy": 5,
            "createdById": 5,
            "lastModifiedOn": 1600169404255,
            "createDatetime": 1600168120467
         }
      ],
      "type": "testSchedule"
   }
]

If no items matching the specified criteria are found, an empty results array is returned:

[
    {
        "firstResult": 0,
        "resultSize": 0,
        "results": [],
        "type": "testcase"
    }
]