Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TestRail Results API

Recorded outcomes for tests and cases.

TestRail Results API is one of 11 APIs that TestRail publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Results. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 7 operations across 7 paths. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against 2 base URLs: https://{instance}.testrail.io/index.php?/api/v2, https://{host}/index.php?/api/v2.

7 operations 7 paths 0 schemas 3 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://{instance}.testrail.io/index.php?/api/v2
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

TestRail Results API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • basicAuth — HTTP Basic authentication. Username is your TestRail email; password is your account password or an API key generated under My Settings. The API must be enable…

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 3 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Results 7

Recorded outcomes for tests and cases.

GET
/get_results/{test_id}
Get results for a test
getResults 3 params → 200
GET
/get_results_for_case/{run_id}/{case_id}
Get results for a case in a run
getResultsForCase 4 params → 200
GET
/get_results_for_run/{run_id}
Get results for a run
getResultsForRun 3 params → 200
POST
/add_result/{test_id}
Add result for a test
addResult 1 param body → 200
POST
/add_result_for_case/{run_id}/{case_id}
Add result for a case in a run
addResultForCase 2 params body → 200
POST
/add_results/{run_id}
Add results (bulk, by test)
addResults 1 param body → 200
POST
/add_results_for_cases/{run_id}
Add results (bulk, by case)
addResultsForCases 1 param body → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

testrail-results-api-openapi.yml Raw ↑

Other APIs TestRail publishes across the network.

TestRail Cases API
TestRail Configurations API
TestRail Milestones API
TestRail Plans API
TestRail Projects API
TestRail Runs API
TestRail Sections API
TestRail Suites API
TestRail Tests API
TestRail Users API