Skip to main content
GET
/
projects
/
{project_id}
/
runs
/
{run_id}
Get run
curl --request GET \
  --url https://{your-subdomain}.neetoplaydash.com/api/external/v1/projects/{project_id}/runs/{run_id} \
  --header 'Accept: <accept>' \
  --header 'X-Api-Key: <x-api-key>'
{
  "project_id": "pdqmxlz",
  "run_id": "kftwnab",
  "commit_id": "9fceb02e1d2c4bb6a1f3f6b0c8e7d5a1b2c3d4e5",
  "created_at": "2026-06-28T09:14:22.000Z",
  "commit_name": "Fix flaky checkout spec",
  "status": "passed",
  "duration": 182.45,
  "ci_build_id": "gh-actions-4821",
  "branch": "main",
  "author": "Oliver Smith",
  "tags": [
    "smoke",
    "nightly"
  ],
  "is_running": false,
  "run_statistics": [
    {
      "name": "Passed",
      "value": 38
    },
    {
      "name": "Failed",
      "value": 2
    },
    {
      "name": "Flaky",
      "value": 1
    }
  ],
  "total_shards": 4,
  "specs": [
    {
      "spec_id": "wbnxtyz",
      "file_name": "cart.spec.ts",
      "tests": [
        {
          "test_id": "vhrscje",
          "title": "adds an item to the cart",
          "status": "passed",
          "duration": 3.21
        }
      ]
    }
  ],
  "pagination": {
    "total_records": 42,
    "total_pages": 3,
    "current_page_number": 1,
    "page_size": 15
  }
}
Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Workspace subdomain.

Headers

​
X-Api-Key
string
required

Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.

​
Accept
enum<string>
default:application/json
required

Specifies the expected response format. Must be set to application/json for proper API communication.

Available options:
application/json

Path Parameters

​
project_id
string
required

Id of the project. You can get project_id by listing your projects using the List projects API.

Example:

"pdqmxlz"

​
run_id
string
required

Id of the run. You can get run_id by listing runs using the List runs API.

Example:

"kftwnab"

Query Parameters

​
status
enum<string>

Filter the returned tests by status. Only specs that contain at least one matching test are returned.

Available options:
passed,
failed,
skipped,
interrupted,
timed_out,
flaky
Example:

"failed"

​
page
integer

Page of specs to retrieve, starting from 1. Defaults to 1 when omitted.

Example:

1

​
page_size
integer

Number of records returned per page. Each endpoint applies its own default and maximum value.

Example:

15

Response

200 - application/json

OK - Request succeeded. Specs are paginated with a default of 30 per page (maximum 100).

​
project_id
string

Unique identifier of the project.

Example:

"pdqmxlz"

​
run_id
string

Unique identifier of the run.

Example:

"kftwnab"

​
commit_id
string

SHA of the commit the run was triggered for.

Example:

"9fceb02e1d2c4bb6a1f3f6b0c8e7d5a1b2c3d4e5"

​
created_at
string<date-time>

Time at which the run was created.

Example:

"2026-06-28T09:14:22.000Z"

​
commit_name
string

Commit message associated with the run.

Example:

"Fix flaky checkout spec"

​
status
enum<string>

Current status of the run.

Available options:
running,
passed,
failed,
passing,
failing,
timedOut,
interrupted
Example:

"passed"

​
duration
number | null

Total duration of the run in seconds.

Example:

182.45

​
ci_build_id
string

Identifier of the CI build that reported the run.

Example:

"gh-actions-4821"

​
branch
string | null

Branch the run was executed on.

Example:

"main"

​
author
string | null

Author of the commit.

Example:

"Oliver Smith"

​
tags
string[]

Tags associated with the run.

Example:
["smoke", "nightly"]
​
is_running
boolean

Whether the run is still in progress.

Example:

false

​
run_statistics
object[]

Aggregated count of tests grouped by their status.

Example:
[
  { "name": "Passed", "value": 38 },
  { "name": "Failed", "value": 2 },
  { "name": "Flaky", "value": 1 }
]
​
total_shards
integer | null

Total number of shards configured for the run.

Example:

4

​
specs
object[]

Specs executed in the run along with their grouped tests.

​
pagination
object