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

# Get Run

> Get a specific job run by ID.



## OpenAPI

````yaml https://hub.griff.services/documentation/json get /runs/{id}
openapi: 3.1.0
info:
  title: Griffin Hub API
  description: API for managing and running test monitors
  version: 1.0.0
servers:
  - url: https://hub.griff.services
    description: Local development server
  - url: http://localhost:3000
    description: Local development server
security:
  - bearerAuth: []
tags:
  - name: monitors
    description: Test monitor management endpoints
  - name: runs
    description: Test run management endpoints
  - name: metrics
    description: Metrics and health summary endpoints
paths:
  /runs/{id}:
    get:
      tags:
        - runs
      summary: Get Run
      description: Get a specific job run by ID.
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    allOf:
                      - type: object
                        required:
                          - id
                          - monitorId
                          - executionGroupId
                          - location
                          - environment
                          - status
                          - triggeredBy
                          - startedAt
                        properties:
                          id:
                            type: string
                          monitorId:
                            type: string
                          executionGroupId:
                            type: string
                          location:
                            type: string
                          environment:
                            type: string
                          status:
                            type: string
                            enum:
                              - pending
                              - running
                              - completed
                              - failed
                          triggeredBy:
                            type: string
                            enum:
                              - schedule
                              - manual
                              - api
                          startedAt:
                            type: string
                            format: date-time
                          completedAt:
                            type: string
                            format: date-time
                          duration_ms:
                            type: number
                          success:
                            type: boolean
                          errors:
                            type: array
                            items:
                              type: string
                          browser:
                            type: string
                      - type: object
                        required:
                          - monitor
                        properties:
                          monitor:
                            type: object
                            required:
                              - id
                              - name
                              - version
                              - frequency
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                              version:
                                type: string
                              frequency:
                                type: object
                                required:
                                  - every
                                  - unit
                                properties:
                                  every:
                                    type: number
                                  unit:
                                    type: string
                                    enum:
                                      - MINUTE
                                      - HOUR
                                      - DAY
                              locations:
                                type: array
                                items:
                                  type: string
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '502':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '504':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````