> ## 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.

# TestDino Public API

> Read-only REST access to test runs, manual test cases, analytics, and project health data.

The TestDino Public API provides read-only REST access to test runs, manual test cases, analytics, and project health data. Use it to pull test data into internal dashboards, build custom reports, or integrate TestDino into your CI/CD tooling.

## Base URL

```text theme={null}
https://api.testdino.com/api/v1/public
```

Every endpoint is scoped to a single project, so every request URL includes a `{projectId}` segment after the base:

```text theme={null}
https://api.testdino.com/api/v1/public/{projectId}/test-runs
https://api.testdino.com/api/v1/public/{projectId}/dashboard
https://api.testdino.com/api/v1/public/{projectId}/analytics/summary
```

Replace `{projectId}` with the ID of the project you want to query. Your PAT must have access to that project.

## What's covered

| Section                                                                              | Use it to                                                 |
| :----------------------------------------------------------------------------------- | :-------------------------------------------------------- |
| [Token Info](/api-reference/endpoints/token-info/verify-token)                       | Verify a PAT and read project/org metadata                |
| [Dashboard](/api-reference/endpoints/dashboard/get-dashboard)                        | Project health overview                                   |
| [Test Runs](/api-reference/endpoints/test-runs/list-test-runs)                       | List and drill into Playwright test runs                  |
| [Test Cases](/api-reference/endpoints/test-cases/get-test-case-details)              | Inspect automated test cases and execution history        |
| [Specs](/api-reference/endpoints/specs/list-specs)                                   | Surface spec file health (flakiness, duration, pass rate) |
| [Test Case Explorer](/api-reference/endpoints/test-case-explorer/explore-test-cases) | Aggregated metrics across runs                            |
| [Context](/api-reference/endpoints/context/get-failure-context)                      | Bundled failure context for AI agents and debugging       |
| [Analytics](/api-reference/endpoints/analytics/analytics-summary)                    | Summary metrics and performance trends                    |
| [Manual Tests](/api-reference/endpoints/manual-tests/list-manual-test-cases)         | Read manual suites, cases, and steps                      |
| [Reports](/api-reference/endpoints/reports/generate-pdf-report)                      | Generate PDF reports                                      |
| [Filters](/api-reference/endpoints/filters/get-filter-values)                        | Discover environments, branches, developers, tags         |
| [Usage](/api-reference/endpoints/usage/get-usage)                                    | Subscription usage and project allocation                 |

## API standards

Every endpoint follows the same patterns for authentication, pagination, date filtering, and errors. Read [API Standards](/api-reference/conventions) once and you won't need to re-read it per endpoint.

<CardGroup cols={3}>
  <Card title="Authentication" icon="key" href="/api-reference/conventions#authentication">
    Bearer PAT, scoped to your projects.
  </Card>

  <Card title="Rate limits" icon="gauge-high" href="/api-reference/conventions#rate-limits">
    100/min token, 200/min IP.
  </Card>

  <Card title="Response format" icon="brackets-curly" href="/api-reference/conventions#response-format">
    Success and error envelope shape.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/api-reference/conventions#errors">
    Codes, statuses, retry guidance.
  </Card>

  <Card title="Pagination" icon="list-ol" href="/api-reference/conventions#pagination">
    `page` / `limit` iteration.
  </Card>

  <Card title="Date filtering" icon="calendar" href="/api-reference/conventions#date-filtering">
    `dateRange` or `startDate`/`endDate`.
  </Card>
</CardGroup>