> ## 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.

# List Runs

> List job runs with optional filtering by monitor and status. Supports pagination.



## OpenAPI

````yaml https://hub.griff.services/documentation/json get /runs/
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/:
    get:
      tags:
        - runs
      summary: List Runs
      description: >-
        List job runs with optional filtering by monitor and status. Supports
        pagination.
      parameters:
        - schema:
            type: string
          in: query
          name: monitorId
          required: false
        - schema:
            type: string
            enum:
              - pending
              - running
              - completed
              - failed
            title: JobRunStatus
          in: query
          name: status
          required: false
        - schema:
            type: number
            minimum: 1
            maximum: 100
          in: query
          name: limit
          required: false
        - schema:
            type: number
            minimum: 0
          in: query
          name: offset
          required: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - total
                  - page
                  - limit
                properties:
                  data:
                    type: array
                    items:
                      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
                              title: TriggerType
                            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
                  total:
                    type: number
                  page:
                    type: number
                  limit:
                    type: number
        '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

````