Skip to main content
GET
/
projects
/
{projectUuid}
/
runs
/
{shortId}
Get run status
curl --request GET \
  --url https://app.qa.tech/api/projects/{projectUuid}/runs/{shortId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "shortId": "abc123",
  "status": "COMPLETED",
  "result": "FAILED",
  "failedTestCases": [
    {
      "id": "test-case-uuid",
      "shortId": "xyz789",
      "name": "Login flow test",
      "status": "COMPLETED",
      "result": "FAILED",
      "resultTitle": "Could not find login button",
      "evaluationThought": "The test failed because the login button was not visible on the page.",
      "promptGoal": "Test the login flow",
      "promptExamples": null
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization
string
required

Bearer token for API authentication

Example:

"Bearer your-api-token"

Path Parameters

projectUuid
string
required

The UUID of your project (found embedded in code examples at Settings → Integrations → API)

shortId
string
required

The 6-character short ID of the run (returned from Start Run API response: run.shortId)

Response

Successfully retrieved run status

id
string<uuid>
required

Internal run identifier

Example:

"550e8400-e29b-41d4-a716-446655440000"

shortId
string
required

6-character short ID used in URLs

Example:

"abc123"

status
enum<string>
required

Current run status

Available options:
INITIATED,
RUNNING,
COMPLETED,
ERROR,
CANCELLED
Example:

"COMPLETED"

result
enum<string> | null
required

Test result when status is COMPLETED, null otherwise

Available options:
PASSED,
FAILED,
SKIPPED
Example:

"FAILED"

failedTestCases
object[]
required

Array of failed test cases (only populated when result is FAILED)