> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobileboost.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get run status

> Retrieve the status and per-test results for a specific run. Each result entry contains the test ID, title, status, a link to the recording, and a link to the per-step interaction logs.



## OpenAPI

````yaml /openapi.json get /runs/{run_id}
openapi: 3.0.2
info:
  title: MobileBoost API
  version: 1.0.0
servers:
  - url: https://api.mobileboost.io
security:
  - BearerAuth: []
paths:
  /runs/{run_id}:
    get:
      summary: Get run status
      description: >-
        Retrieve the status and per-test results for a specific run. Each result
        entry contains the test ID, title, status, a link to the recording, and
        a link to the per-step interaction logs.
      operationId: get_run_status
      parameters:
        - required: true
          schema:
            title: Run ID
            type: string
          name: run_id
          in: path
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  runId:
                    type: string
                    description: The ID of the run.
                  status:
                    type: string
                    description: >-
                      Overall status of the run (e.g. `pending`, `running`,
                      `completed`).
                  totalTests:
                    type: integer
                    description: Total number of tests in the run.
                  succeededTests:
                    type: array
                    items:
                      $ref: '#/components/schemas/TestRunResult'
                    description: Tests that succeeded.
                  failedTests:
                    type: array
                    items:
                      $ref: '#/components/schemas/TestRunResult'
                    description: Tests that failed.
                  blockedTests:
                    type: array
                    items:
                      $ref: '#/components/schemas/TestRunResult'
                    description: Tests that were blocked.
              example:
                runId: abc123
                status: completed
                totalTests: 2
                succeededTests:
                  - id: test1
                    title: Login flow
                    status: succeeded
                    recording: https://app.mobileboost.io/recording/abc123/runs/test1
                    interactionLogs: >-
                      https://api.mobileboost.io/suite/abc123/run/test1/interaction_logs?organisation_id=org123
                failedTests:
                  - id: test2
                    title: Checkout flow
                    status: failed
                    recording: https://app.mobileboost.io/recording/abc123/runs/test2
                    interactionLogs: >-
                      https://api.mobileboost.io/suite/abc123/run/test2/interaction_logs?organisation_id=org123
                blockedTests: []
components:
  schemas:
    TestRunResult:
      title: TestRunResult
      type: object
      properties:
        id:
          type: string
          description: The test run ID.
        title:
          type: string
          description: The test title.
        status:
          type: string
          description: The test result status (`succeeded`, `failed`, or `blocked`).
        recording:
          type: string
          description: URL to the test's recording in the MobileBoost dashboard.
        interactionLogs:
          type: string
          description: URL to the per-step interaction logs for this test run.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````