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

> Lists your team's monitors, newest first.



## OpenAPI

````yaml /openapi.json get /v1/monitors
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for people and companies: research 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:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - 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: Feedback
    description: >-
      Tell us a result was wrong, missing or outdated, and report problems with
      the API, the docs or a tool.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Start, continue and read Atlas investigations: attribution graph,
      workspace files, reports and exports.
paths:
  /v1/monitors:
    get:
      tags:
        - Monitors V1
      summary: List Monitors
      description: Lists your team's monitors, newest first.
      operationId: list_monitors_v1_monitors_get
      parameters:
        - name: active_only
          in: query
          required: false
          schema:
            type: boolean
            description: 'If true, returns only monitors that are running. Default: false.'
            default: false
            title: Active Only
          description: 'If true, returns only monitors that are running. Default: false.'
        - name: include_canceled
          in: query
          required: false
          schema:
            type: boolean
            description: 'If false, leaves out canceled monitors. Default: true.'
            default: true
            title: Include Canceled
          description: 'If false, leaves out canceled monitors. Default: true.'
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: 'Monitors per page. Default: 50. Range: 1 to 200.'
            default: 50
            title: Page Size
          description: 'Monitors per page. Default: 50. Range: 1 to 200.'
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 2048
              - type: 'null'
            description: '`next_cursor` from the previous page. Omit for the first page.'
            title: Cursor
          description: '`next_cursor` from the previous page. Omit for the first page.'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MonitorPage'
              example:
                items:
                  - monitor_id: 9a4d2c1b-6e7f-4a8b-b3c2-1d0e9f8a7b6c
                    type: research
                    name: Target accounts
                    status: active
                    subject_type: company
                    fields:
                      headcount: Number of employees
                    frequency: 1w
                    tier: low
                    research_plan: null
                    is_active: true
                    disabled_reason: null
                    webhook_url: https://example.com/webhooks/sixtyfour
                    webhook_event_types:
                      - monitor.field.changed
                    metadata: null
                    row_count: 1
                    active_row_count: 1
                    last_run_at: '2026-11-13T10:00:00Z'
                    next_run_times:
                      - '2026-11-20T10:00:00Z'
                    created_at: '2026-11-06T10:00:00Z'
                    updated_at: '2026-11-13T10:00:00Z'
                next_cursor: null
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobValidationError'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Service Unavailable
components:
  schemas:
    MonitorPage:
      properties:
        items:
          items:
            $ref: '#/components/schemas/Monitor'
          type: array
          title: Items
          description: Monitors in this page, newest first.
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: >-
            Pass as cursor to read the next page. Null when no more results
            remain.
      type: object
      required:
        - items
      title: MonitorPage
    PublicJobError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
      title: PublicJobError
    PublicJobValidationError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
        errors:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Errors
          description: >-
            Individual validation failures, each with a parameter location
            (`loc`), message (`msg`), and error type (`type`).
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
        - errors
      title: PublicJobValidationError
    Monitor:
      properties:
        monitor_id:
          type: string
          title: Monitor Id
          description: Monitor identifier.
        type:
          type: string
          enum:
            - research
            - linkedin
          title: Type
          description: '`research` or `linkedin`.'
        name:
          type: string
          title: Name
          description: Name of the monitor.
        status:
          type: string
          enum:
            - starting
            - active
            - paused
            - failed
            - canceled
          title: Status
          description: >-
            `starting` while rows from a file are still being added, `active`
            when it runs on schedule, `paused` when switched off, `failed` when
            adding rows failed, `canceled` when canceled.
        subject_type:
          type: string
          enum:
            - company
            - person
          title: Subject Type
          description: What each row is.
        fields:
          additionalProperties: true
          type: object
          title: Fields
          description: The watched fields.
        frequency:
          type: string
          title: Frequency
          description: How often the monitor checks its rows.
        tier:
          type: string
          title: Tier
          description: Research depth for each check.
        research_plan:
          anyOf:
            - type: string
            - type: 'null'
          title: Research Plan
          description: Additional research instructions. Null when none were set.
        is_active:
          type: boolean
          title: Is Active
          description: If true, the monitor runs on its schedule.
        disabled_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Disabled Reason
          description: Why the monitor is not running. Null when it is running.
        webhook_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Webhook Url
          description: URL that receives the monitor's events. Null when none is set.
        webhook_event_types:
          items:
            type: string
          type: array
          title: Webhook Event Types
          description: Events sent to `webhook_url`.
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata
          description: Your own data stored on the monitor.
        row_count:
          type: integer
          title: Row Count
          description: Number of rows in the monitor.
        active_row_count:
          type: integer
          title: Active Row Count
          description: Number of rows that are still checked.
        last_run_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Run At
          description: >-
            Start time of the most recent check in UTC. Null before the first
            check.
        next_run_times:
          items:
            type: string
          type: array
          title: Next Run Times
          description: Up to three upcoming check times in UTC. Empty when not running.
        created_at:
          type: string
          title: Created At
          description: Creation time in UTC, in ISO 8601 format.
        updated_at:
          type: string
          title: Updated At
          description: Last update time in UTC, in ISO 8601 format.
      type: object
      required:
        - monitor_id
        - type
        - name
        - status
        - subject_type
        - fields
        - frequency
        - tier
        - is_active
        - webhook_event_types
        - row_count
        - active_row_count
        - next_run_times
        - created_at
        - updated_at
      title: Monitor
      examples:
        - active_row_count: 2
          created_at: '2025-12-30T18:04:11.482913+00:00'
          fields:
            headcount: Current number of employees
            latest_funding: Most recent funding round and amount
          frequency: 1d
          is_active: true
          last_run_at: '2026-01-05T09:00:04+00:00'
          metadata:
            crm_list: enterprise
          monitor_id: 5b0f6a1c-2d3e-4f70-8a9b-1c2d3e4f5a6b
          name: Target accounts
          next_run_times:
            - '2026-01-06T09:00:00+00:00'
            - '2026-01-07T09:00:00+00:00'
            - '2026-01-08T09:00:00+00:00'
          row_count: 2
          status: active
          subject_type: company
          tier: low
          type: research
          updated_at: '2026-01-05T09:00:04.118204+00:00'
          webhook_event_types:
            - monitor.field.changed
          webhook_url: https://example.com/hooks/sixtyfour
    V1ErrorCode:
      type: string
      enum:
        - invalid_cursor
        - request_in_progress
        - limit_exceeded
        - entity_type_mismatch
        - unsupported_file
        - invalid_upload
        - file_too_large
        - items_not_available
        - list_not_ready
        - job_not_finished
        - not_found
        - validation_error
        - rate_limited
        - internal_error
        - unavailable
        - unauthenticated
        - forbidden
        - insufficient_credits
        - idempotency_key_reused
        - export_source_changed
        - job_execution_changed
        - job_failed
        - item_failed
        - aborted
        - workflow_changed
        - workflow_locked
        - workflow_not_runnable
        - timed_out
      title: V1ErrorCode
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Sixtyfour API key.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        An OAuth access token from `POST /oauth/token`, sent as `Authorization:
        Bearer <token>`. An API key sent as a bearer token is refused with 401.
        When both headers are sent, the bearer token is used.

````

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