> ## Documentation Index > Fetch the complete documentation index at: https://docs.testdino.com/llms.txt > Use this file to discover all available pages before exploring further. # List manual test cases with filtering > Returns a filterable list of manual test cases (single page). Supports classification and automation filters, suite, and tags. **No `page` or sort params** — TCM returns one page ordered by `createdAt` desc. Search matches title and caseId only (case-insensitive). ## OpenAPI ````yaml /api-reference/openapi.yml get /{projectId}/manual-tests openapi: 3.0.3 info: title: TestDino Public API version: 1.0.0 description: > Public API for TestDino — read-only access to test analytics, manual tests, and project data. **17 read-only GET endpoints** organized into 12 sections. Query parameters are **endpoint-specific** — see each operation for supported filters, enums, and defaults. ## Authentication All endpoints require a Bearer token in the `Authorization` header: ``` Authorization: Bearer td_pat_ ``` Use a user PAT (`td_pat_` prefix) scoped to the organization/project. ## Rate Limiting - **Per-token:** 100 requests/minute - **Per-IP (pre-auth):** 200 requests/minute - **PDF generation:** 1 request/minute per token Standard headers: `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` ## Response Format **Success:** ```json { "success": true, "data": { ... }, "pagination": { ... } } ``` **Error:** ```json { "success": false, "error": { "code": "ERROR_CODE", "message": "Human-readable message" } } ``` ## Time windows and date filters There is **no global date-filter convention**. Each endpoint documents its own parameters: | Endpoint family | Parameter | Allowed values | |-----------------|-----------|------------------| | Test runs list | `start_date`, `end_date` | RFC3339 timestamps (both required together) | | Explorer, specs, analytics | `days` | Integer snapped to **7, 30, or 90** (see each endpoint) | | Test runs list | — | No preset `period` / `dateRange` params | | Dashboard, filters | — | **No query params** (fixed downstream snapshot) | ## Served by This contract is served by the **MCP service** (the gateway), which authenticates the `td_pat_` user PAT and fans out to data-handler / tcm / user-service / billing. It is **read-only** — webhook subscription management (the previous public API's only write surface) is owned by the **integration service** and is not part of this contract. ## Implementation status All 17 routes are mounted (auth + rate-limit). Most call their real downstream today; a few still have lean shapes or pending owners (notably `usage` → billing). Live vs pending detail: `docs/DOWNSTREAM_WORK.md`. contact: name: TestDino Support url: https://docs.testdino.com servers: - url: https://api.testdino.com/api/v1/public description: Production security: - BearerAuth: [] tags: - name: Token Info description: Token introspection and project metadata - name: Test Runs description: List, inspect, and drill into test runs - name: Test Cases description: Automated test case details and history - name: Specs description: Project-level spec file health - name: Manual Tests description: Manual test suites and cases (read-only) - name: Test Case Explorer description: Aggregated test case metrics explorer - name: Context description: >- Debugging payload at three levels (run / suite / test) — error, steps, failure window, attempts, attachments, trace, deep links, and a copy-paste retry command. Designed for AI agents and CI scripts. - name: Dashboard description: Project health overview - name: Filters description: Available filter values (environments, branches, developers, tags) - name: Reports description: PDF report generation and download - name: Analytics description: Consolidated analytics summary and test case execution performance - name: Usage description: Subscription usage and limits paths: /{projectId}/manual-tests: get: tags: - Manual Tests summary: List manual test cases with filtering description: > Returns a filterable list of manual test cases (single page). Supports classification and automation filters, suite, and tags. **No `page` or sort params** — TCM returns one page ordered by `createdAt` desc. Search matches title and caseId only (case-insensitive). parameters: - $ref: '#/components/parameters/projectId' - name: limit in: query schema: type: integer default: 100 minimum: 1 maximum: 1000 description: Max cases to return (1–1000, default 100). - name: search in: query schema: type: string description: Free-text search across title and caseId. - name: status in: query schema: type: string enum: - active - draft - deprecated description: Filter by classification status. - name: severity in: query schema: type: string enum: - blocker - critical - major - normal - minor - trivial - not_set description: Filter by severity level. - name: priority in: query schema: type: string enum: - critical - high - medium - low - not_set description: Filter by priority. - name: type in: query schema: type: string enum: - smoke - regression - functional - integration - e2e - api - unit - performance - security - accessibility - usability - compatibility - acceptance - exploratory - other description: Filter by test type. - name: layer in: query schema: type: string enum: - e2e - api - unit - not_set description: Filter by test layer. - name: behavior in: query schema: type: string enum: - positive - negative - destructive - not_set description: Filter by expected behavior type. - name: automationStatus in: query schema: type: string enum: - manual - automated - to_be_automated description: Filter by automation status. - name: suiteId in: query schema: type: string description: >- Filter to test cases belonging to this suite. Use `null` for unassigned cases. - name: tags in: query schema: type: string description: >- Comma-separated tags to filter by (e.g. `smoke,login`). Returns cases matching any of the tags. responses: '200': description: Manual test cases content: application/json: schema: type: object properties: success: type: boolean data: type: array items: $ref: '#/components/schemas/ManualTestCaseListItem' count: type: integer description: Total cases returned in `data`. '401': $ref: '#/components/responses/Unauthorized' components: parameters: projectId: name: projectId in: path required: true schema: type: string description: >- The project identifier (e.g. `project_abc123`). Must match the project associated with your PAT. schemas: ManualTestCaseListItem: type: object properties: _id: type: string example: tcm_tc_6641a1b2c3d4e5f6a7b8c9d0 caseId: type: string example: TC-1 title: type: string example: Verify login with valid credentials description: type: string preconditions: type: string postconditions: type: string metadata: type: object description: >- Public-shaped: internal `project` and `createdBy` are stripped; `lastModifiedBy` is collapsed to name + email. properties: suite: type: object nullable: true description: Populated suite (name only) properties: _id: type: string name: type: string lastModifiedBy: $ref: '#/components/schemas/CollapsedUser' classification: $ref: '#/components/schemas/Classification' automation: $ref: '#/components/schemas/Automation' steps: $ref: '#/components/schemas/Steps' tags: type: array items: type: string customFields: type: object description: Key-value pairs defined by project-level custom field definitions additionalProperties: true linkedTests: type: array items: $ref: '#/components/schemas/LinkedTest' attachments: type: array items: $ref: '#/components/schemas/Attachment' createdAt: type: string format: date-time updatedAt: type: string format: date-time CollapsedUser: type: object nullable: true description: User reference collapsed to display name and email for public responses. properties: name: type: string email: type: string Classification: type: object properties: status: type: string description: Test case status example: active enum: - active - draft - deprecated severity: type: string description: Severity level example: critical enum: - blocker - critical - major - normal - minor - trivial - not_set priority: type: string description: Priority level example: high enum: - critical - high - medium - low - not_set type: type: string description: Test type example: functional enum: - smoke - regression - functional - integration - e2e - api - unit - performance - security - accessibility - usability - compatibility - acceptance - exploratory - other layer: type: string description: Test layer example: e2e enum: - e2e - api - unit - not_set behavior: type: string description: Expected behavior type example: positive enum: - positive - negative - destructive - not_set Automation: type: object properties: status: type: string description: Automation status example: manual enum: - manual - automated - to_be_automated toBeAutomated: type: boolean isFlaky: type: boolean isMuted: type: boolean Steps: type: object properties: type: type: string enum: - classic - gherkin description: >- Step format — `classic` uses action/data/expectedResult, `gherkin` uses Given/When/Then keywords. classic: type: array items: $ref: '#/components/schemas/ClassicStep' gherkin: type: array items: $ref: '#/components/schemas/GherkinStep' LinkedTest: type: object properties: _id: type: string fullTitle: type: string description: Full title of the linked automated test case displayTitle: type: string nullable: true linkedAt: type: string format: date-time source: type: string enum: - manual_link - auto_created Attachment: type: object properties: _id: type: string fileName: type: string originalFileName: type: string fileSize: type: integer mimeType: type: string blobUrl: type: string uploadedAt: type: string format: date-time stepRef: type: string nullable: true description: >- Dot-separated index path linking the attachment to a step (e.g. `0`, `1.2`) ErrorEnvelope: type: object properties: success: type: boolean enum: - false error: type: object properties: code: type: string message: type: string ClassicStep: type: object properties: step: type: integer description: Step number action: type: string description: Action to perform maxLength: 5000 data: type: string description: Test data for this step maxLength: 5000 expectedResult: type: string description: Expected result after performing the action maxLength: 5000 subSteps: type: array description: Nested sub-steps (up to 5 levels deep) items: $ref: '#/components/schemas/ClassicStep' GherkinStep: type: object properties: step: type: integer description: Step number keyword: type: string enum: - Given - When - Then - And - But text: type: string description: Step description maxLength: 5000 subSteps: type: array description: Nested sub-steps (up to 5 levels deep) items: $ref: '#/components/schemas/GherkinStep' responses: Unauthorized: description: Missing, invalid, expired, or revoked token content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: success: false error: code: AUTH_INVALID_TOKEN message: Invalid or expired token securitySchemes: BearerAuth: type: http scheme: bearer description: User PAT (td_pat_) scoped to the target project ````