Skip to main content
GET
/
projects
/
{project_id}
/
runs
List runs
curl --request GET \
  --url https://{your-subdomain}.neetoplaydash.com/api/external/v1/projects/{project_id}/runs \
  --header 'Accept: <accept>' \
  --header 'X-Api-Key: <x-api-key>'
{
  "runs": [
    {
      "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
        }
      ]
    }
  ],
  "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"

Query Parameters

​
branch
string

Filter runs by branch name.

Example:

"main"

​
status
enum<string>

Filter runs by status. Current status of the run.

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

"passed"

​
page_number
integer
default:1

Page of results 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. Defaults to 15 runs per page (maximum 50).

​
runs
object[]
​
pagination
object