Instances

Query spec file execution instances.

An instance represents a single spec file execution within a run. It contains detailed information about test results, duration, and machine that executed the spec file.

Get instance

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/instances/{instanceId}

Get a single spec file execution instance by ID with full test results

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

instanceIdstringRequired

The instance ID

Example: inst_abc123

Responses

200

Successful response

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/instances/{instanceId}

HTTPcURLJavaScriptPython

GET /v1/instances/{instanceId} HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "instanceId": "text",
    "runId": "text",
    "groupId": "text",
    "spec": "text",
    "machineId": "text",
    "claimedAt": "2026-01-08T01:47:49.684Z",
    "completedAt": "2026-01-08T01:47:49.684Z",
    "results": {
      "stats": {
        "tests": 1,
        "passes": 1,
        "failures": 1,
        "pending": 1,
        "skipped": 1
      },
      "exception": "text",
      "flaky": 1,
      "tests": [
        {
          "testId": "text",
          "title": [
            "text"
          ],
          "state": "passed",
          "displayError": "text",
          "attempts": [
            {
              "attemptId": "text",
              "state": "text",
              "wallClockStartedAt": "2026-01-08T01:47:49.684Z",
              "wallClockDuration": 1,
              "error": {
                "message": "text",
                "stack": "text"
              }
            }
          ]
        }
      ]
    }
  }
}