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

# List Monitor Runs

> Check runs, newest first. Recover missed webhook run IDs here.

Run history starts when run tracking is deployed; older checks are not
reconstructed from timestamps. `rows_checked` counts successful checks,
including quiet ones; failed/skipped rows are reported separately. Counts
are finalized when the run settles. `failed` means the group could not
establish a complete, correlated result (for example a failed batch).
Use `next_cursor` as `cursor` on the next request.
Example: `{"runs": [], "next_cursor": null}` for a monitor without tracked runs.



## OpenAPI

````yaml https://api.sixtyfour.ai/openapi.json get /monitors/{monitor_id}/runs
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for People and Entities. Deploy AI agents that investigate,
    resolve identities, map relationships, and surface risk signals
  contact:
    name: Sixtyfour
    url: https://sixtyfour.ai/
    email: support@sixtyfour.ai
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sixtyfour.ai
    description: Production
security: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - name: org-chart
    description: Discover people inside a company and build org charts.
  - name: Search
    description: Run deep and filter searches over Sixtyfour's data.
  - name: Workflow
    description: Create, run, and manage enrichment workflows.
  - name: Workflow Schedules
    description: Create and manage recurring schedules for workflows.
  - name: Account
    description: Manage and inspect your account and credit balance.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Read your Atlas investigations: attribution graph, workspace files,
      reports, and exports.
paths:
  /monitors/{monitor_id}/runs:
    get:
      tags:
        - Monitors
      summary: List Monitor Runs
      description: >-
        Check runs, newest first. Recover missed webhook run IDs here.


        Run history starts when run tracking is deployed; older checks are not

        reconstructed from timestamps. `rows_checked` counts successful checks,

        including quiet ones; failed/skipped rows are reported separately.
        Counts

        are finalized when the run settles. `failed` means the group could not

        establish a complete, correlated result (for example a failed batch).

        Use `next_cursor` as `cursor` on the next request.

        Example: `{"runs": [], "next_cursor": null}` for a monitor without
        tracked runs.
      operationId: list_monitor_runs_endpoint_monitors__monitor_id__runs_get
      parameters:
        - name: monitor_id
          in: path
          required: true
          schema:
            type: string
            title: Monitor Id
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            default: 100
            title: Limit
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Cursor
        - name: x-api-key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MonitorRunPage'
        '400':
          description: Request was rejected by the route's validation rules.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Invalid request body
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Invalid API key
        '403':
          description: Organization access is locked.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: >-
                  This organization no longer has access to Sixtyfour. Contact
                  your representative at Sixtyfour.
        '422':
          description: Invalid request fields or monitor input.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MonitorValidationErrorResponse'
        '500':
          description: Unexpected server error. Retry with backoff.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Internal server error
        '503':
          description: >-
            The API key could not be checked, or the request could not be
            started, because a backing service is briefly unavailable. Nothing
            was charged. Retry after the `Retry-After` header.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Could not verify the API key right now. Retry shortly.
components:
  schemas:
    MonitorRunPage:
      properties:
        runs:
          items:
            $ref: '#/components/schemas/MonitorRunResponse'
          type: array
          title: Runs
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      type: object
      required:
        - runs
      title: MonitorRunPage
    MonitorValidationErrorResponse:
      properties:
        detail:
          anyOf:
            - type: string
            - items:
                $ref: '#/components/schemas/MonitorValidationErrorItem'
              type: array
          title: Detail
      type: object
      required:
        - detail
      title: MonitorValidationErrorResponse
      description: Both FastAPI field errors and explicit monitor validation failures.
    MonitorRunResponse:
      properties:
        run_id:
          type: string
          title: Run Id
        status:
          type: string
          enum:
            - running
            - completed
            - failed
          title: Status
        started_at:
          type: string
          title: Started At
        completed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Completed At
        rows_total:
          type: integer
          title: Rows Total
        rows_checked:
          type: integer
          title: Rows Checked
        rows_failed:
          type: integer
          title: Rows Failed
        rows_skipped:
          type: integer
          title: Rows Skipped
        rows_changed:
          type: integer
          title: Rows Changed
      type: object
      required:
        - run_id
        - status
        - started_at
        - rows_total
        - rows_checked
        - rows_failed
        - rows_skipped
        - rows_changed
      title: MonitorRunResponse
    MonitorValidationErrorItem:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Loc
          description: Path to the invalid field
          examples:
            - - body
              - name
        msg:
          type: string
          title: Msg
          description: Human-readable error message
          examples:
            - Field required
        type:
          type: string
          title: Type
          description: Validation error code
          examples:
            - missing
        input:
          title: Input
        ctx:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Ctx
      type: object
      required:
        - loc
        - msg
        - type
      title: MonitorValidationErrorItem
      description: A FastAPI request-validation error, including its field path.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.