Skip to main content
GET
/
{projectId}
/
manual-tests
List manual test cases
curl --request GET \
  --url https://api.testdino.com/api/public/v1/{projectId}/manual-tests \
  --header 'Authorization: Bearer <token>'
{
  "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": {
        "type": "classic",
        "classic": [
          {
            "step": 123,
            "action": "<string>",
            "data": "<string>",
            "expectedResult": "<string>",
            "subSteps": "<array>"
          }
        ],
        "gherkin": [
          {
            "step": 123,
            "keyword": "Given",
            "text": "<string>",
            "subSteps": "<array>"
          }
        ]
      },
      "tags": [
        "<string>"
      ],
      "customFields": {},
      "linkedTests": [
        {
          "_id": "<string>",
          "fullTitle": "<string>",
          "displayTitle": "<string>",
          "linkedAt": "2023-11-07T05:31:56Z",
          "source": "manual_link"
        }
      ],
      "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

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

Manual test cases

success
boolean
data
object[]
pagination
object