List manual test cases

Filterable list of manual test cases.

Filter by classification (status, severity, priority, type, layer, behavior), automation (status, flaky, muted), suite, or tags. Free-text search matches title, description, and caseId (case-insensitive).

GET /{projectId}/manual-tests

List manual test cases

cURL

curl --request GET \
  --url https://api.testdino.com/api/public/v1/{projectId}/manual-tests \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "data": [
    {
      "_id": "tcm_tc_6641a1b2c3d4e5f6a7b8c9d0",
      "caseId": "TC-1",
      "title": "Verify login with valid credentials",
      "description": "<string>",
      "preconditions": "<string>",
      "postconditions": "<string>",
      "metadata": {
        "project": "<string>",
        "suite": {
          "_id": "<string>",
          "name": "<string>"
        },
        "createdBy": {
          "_id": "<string>",
          "firstName": "<string>",
          "lastName": "<string>",
          "email": "<string>"
        },
        "lastModifiedBy": {
          "_id": "<string>",
          "firstName": "<string>",
          "lastName": "<string>",
          "email": "<string>"
        }
      },
      "classification": {
        "status": "active",
        "severity": "critical",
        "priority": "high",
        "type": "functional",
        "layer": "e2e",
        "behavior": "positive"
      },
      "automation": {
        "status": "manual",
        "toBeAutomated": true,
        "isFlaky": true,
        "isMuted": true
      },
      "steps": {
        "classic": [
          {
            "step": 123,
            "action": "<string>",
            "data": "<string>",
            "expectedResult": "<string>",
            "subSteps": "<array>"
          }
        ],
        "gherkin": [
          {
            "step": 123,
            "text": "<string>",
            "subSteps": "<array>"
          }
        ]
      },
      "tags": [
        "<string>"
      ],
      "customFields": {},
      "linkedTests": [
        {
          "_id": "<string>",
          "fullTitle": "<string>",
          "displayTitle": "<string>",
          "linkedAt": "2023-11-07T05:31:56Z"
        }
      ],
      "attachments": [
        {
          "_id": "<string>",
          "fileName": "<string>",
          "originalFileName": "<string>",
          "fileSize": 123,
          "mimeType": "<string>",
          "blobUrl": "<string>",
          "uploadedAt": "2023-11-07T05:31:56Z",
          "stepRef": "<string>"
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "hasNext": true,
    "hasPrev": true
  }
}

Authorizations

Authorization · string · header · required

Project PAT (tdp_) token with public-api scope

Path Parameters

projectId · string · required

The project identifier (e.g. project_abc123). Must match the project associated with your PAT.

Query Parameters

page · integer · default: 1

Page number for paginated results. Starts at 1.

Required range: x >= 1

limit · integer · default: 50

Items per page (1–100, default 50).

Required range: x <= 100

search · string

Free-text search across title, description, and caseId.

status · enum<string>

Filter by classification status.

Available options: active, draft, deprecated

severity · enum<string>

Filter by severity level.

Available options: blocker, critical, major, normal, minor, trivial, not_set

priority · enum<string>

Filter by priority.

Available options: critical, high, medium, low, not_set

type · enum<string>

Filter by test type.

Available options: smoke, regression, functional, integration, e2e, api, unit, performance, security, accessibility, usability, compatibility, acceptance, exploratory, other

layer · enum<string>

Filter by test layer.

Available options: e2e, api, unit, not_set

behavior · enum<string>

Filter by expected behavior type.

Available options: positive, negative, destructive, not_set

automationStatus · enum<string>

Filter by automation status.

Available options: manual, automated, to_be_automated

isFlaky · enum<string>

Filter to flaky (true) or non-flaky (false) test cases.

Available options: true, false

isMuted · enum<string>

Filter to muted (true) or unmuted (false) test cases.

Available options: true, false

suiteId · string

Filter to test cases belonging to this suite. Use null for unassigned cases.

tags · string

Comma-separated tags to filter by (e.g. smoke,login). Returns cases matching any of the tags.

sortBy · string · default: caseId

Field to sort by (e.g. caseId, title, updatedAt, classification.status).

sortOrder · enum<string> · default: asc

Sort direction.

Available options: asc, desc

Response

200

application/json

Manual test cases

success · boolean

data · object[]

Show child attributes

pagination · object

Show child attributes